classname_indexname_prefix_match(patricia)(bit array)

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

Prototype

 
    MCO_RET	classname_indexname_prefix_match( /*IN*/ mco_trans_h t, 
                              /*IN*/ mco_cursor_h c, 
                              /*IN*/ char * mask,
                              /*IN*/ uint2 number_of_bits);
 

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)
number_of_bits	The number of bits to match

Description

This function finds the first object whose index matches the number of bits (specified in argument ‘number_of_bits’) 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