 |
Home | Features | Reference | Downloads | About |
Reference/es_mbb_i8_v
Syntax
int es_mbb_i8_v( struct es_mbb *fb, const char *fieldname, uint8_t *pvar );
Arguments
struct es_mbb *fb |
Field-binding collection. |
|---|---|
const char *fieldname |
Database field name. |
uint8_t *pvar |
Reference to 8bit integer program variable. |
Return Codes
ES_ERROR_NONE |
Success. No errors. |
|---|---|
ES_ERROR_INVALIDFIELDTYPE |
Database field is not an 8bit integer (ES_FLDTYPE_I8). |
ES_ERROR_UNKNOWNFIELD |
Unknown database field in this class. |
Description
Bind by value the 8bit integer program variable referenced by pvar with the database field fieldname. The field-binding fb must have been previously constructed via es_mbb_new().
Binding by value means that the value reference by pvar (i.e. *pvar) is copied to the database during an insert/update operation and fieldname's value is copied to *pvar during a fetch operation.
Index fields (which must be integers) must be bound by value for use in index look-up operations such as es_mbi_findfetch(), es_mbi_findupdate() and es_mbi_findremoveidx().