WYRDTEK Home Features Reference Downloads About



int es_mbb_i64_r( struct es_mbb *fb, const char *fieldname, uint64_t **pvar );


struct es_mbb Field-binding collection.
const char *fieldname Database field name.
uint64_t **pvar Reference to 64bit integer pointer program variable

Return Codes

ES_ERROR_NONE Success. No errors.
ES_ERROR_INVALIDFIELDTYPE Database field is not a 64bit integer (ES_FLDTYPE_I64).
ES_ERROR_UNKNOWNFIELD Unknown database field in this class.


Bind by reference the 64bit 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 reference means that a pointer to fieldname's value is copied to the program variable referenced by pvar during both fetch and update operations. The contents of fieldname may then be read or assigned to directly by de-referencing *pvar.

This is particularly useful for incrementally updating fields which are designated as aggregate values. Database fields are also always zero-initialized which can simplify code.

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