# 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