 |
Home | Features | Reference | Downloads | About |
Reference/es_mbb_mbu_v
Syntax
int es_mbb_str_v( struct es_mbb *fb, const char *fieldname, void *pvar );
Arguments
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. |
Description
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.