WYRDTEK Home Features Reference Downloads About



int es_mbb_str_v( struct es_mbb *fb, const char *fieldname, void *pvar );


struct es_mbb *fb Field-binding collection.
const char *fieldname Database field name.
void *pvar Reference to program variable buffer.

Return Codes

ES_ERROR_NONE Success. No errors.
ES_ERROR_INVALIDFIELDTYPE Field is not defined as a fixed-width field (i.e. ES_FLDTYPE_STR).
ES_ERROR_UNKNOWNFIELD Unknown database field in this class.


Bind by value the contents of the buffer referenced by pvar with the user-defined fixed-width database field fieldname. The field-binding fb must have been previously constructed via es_mbb_new(). The buffer is assumed to be large enough to hold the contents of the database field (i.e. the width defined by es_mbc_addfldstr() ).

Binding by value means that the contents of the buffer reference by pvar is copied to the database during an insert/update operation and fieldname's value is copied to the buffer during a fetch operation.

[Back To Reference] [Back To Reference/es_mbb]