# classname_indexname_longest_match(patricia)(string)(vector)

> This function finds the last object whose index has the ‘deepest’ match (most matching bits) with the key value specified in ‘mask’

### Prototype

>         MCO_RET	classname_indexname_longest_match( /*IN*/ mco_trans_h t,
>                                   /*IN*/ mco_cursor_h c,
>                                   /*IN*/ 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 | The key value specified as a string or vector
sizeofMask | The length of the string or vector argument ‘`mask`’

### Description

> This function finds the last object whose index has the ‘deepest’ match (most matching bits) with 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