classname_indexname_exact_match(patricia)(string/vector)

This function finds the first object whose index matches the number of bytes (specified in argument ‘sizeofMask’) in the key value specified in ‘mask’.

Prototype

 
    MCO_RET	classname_indexname_exact_match( /*IN*/ mco_trans_h t, 
                             /*IN*/ mco_cursor_h c, 
                             /*IN*/ const char * mask,
                             /*IN*/ uint2 sizeofMask );
 

Arguments

t	A transaction handle that was established by mco_trans_start()
c	A cursor handle returned by *_index_cursor
mask	A key value that is a packed bit array (each byte contains 8 bits)
sizeofMask	The length of the string or vector argument ‘mask’

Description

This function finds the first object whose index matches the number of bytes (specified in argument ‘sizeofMask’) in the key value specified in ‘mask’.

Return Codes

MCO_S_OK	A record with index matching ‘mask’ was found
MCO_S_NOTFOUND	No record found matching ‘mask’
MCO_E_DISK_NOT_OPENED	indexname is in a persistent class and disk access was not initialized by db_open_dev()
MCO_E_VOLUNTARY_NOT_EXIST	indexname is voluntary and has not been created, or was dropped
MCO_E_NOMEM	Out of memory
MCO_ERR_CURSOR	Fatal error in cursor operation

Related Topics