# classname_indexname_find

> This function searches the database based on an exact match of index values.

### Prototype

>         MCO_RET	classname_indexname_find(	/*IN*/ mco_trans_h trans,
>                              /*IN*/ <type> [*]param1,
>                              [/*IN*/ uint2 len1,],
>                              [/*IN*/ <type> [*]param2,
>                              [/*IN*/ uint2 len2,] …],
>                              /*OUT*/ classname *handle );

### Arguments

trans | A transaction handle returned by`mco_trans_start()`
param1 | A variable of type type, where type is the data type of the classname.fieldname component of the index. If the index component is char or string, the param is a char *
len1 | If param1 is a char or string, len1 specifies the length of the input buffer
param2 | If the index has more than one component (is a compound index) a search value is input for each component of the index
len2 | If param2 thru paramN are char or string, each such parameter argument is followed by a lenN parameter to specify the length of the paramN buffer
handle | A pointer to a classname which will reference the object located by the find method

### Description

> Find methods search the database based on an exact match of index values. Since exactly one object can be returned, a pointer to an object handle is populated with the reference to the found object.

### Return Codes

MCO_S_OK | The object was located successfully.
MCO_S_NOTFOUND | The search values did not match any object of the class
MCO_ERR_COMMON |

Related Topics