# mco_metadict_entry_name
RT

> Return a pointer to a dictionary.

### Prototype

        MCO_RET mco_metadict_entry_name(	/*IN*/ mco_metadict_header_t * metadict,
                           /*IN*/ const char * name,
                           /*OUT*/ mco_metadict_entry_t ** entry );

### Arguments

metadict | The address of a mco_metadict_header_t structure to initialize
name | The dictionary name
entry | The address of a mco_metadict_entry_t structure

### Description

> This function returns a pointer to the dictionary based on its name `metadict->entries[]->name`.

### Return Codes

MCO_S_OK | The dictionary was successfully returned
MCO_E_UDA_DICT_NOTFOUND | The dictionary is not registered

### Example

        Application snippet:

        const char * dbname = "SimpleDb";

        int main(int argc, char* argv[])
        {
            MCO_RET rc;
            unsigned int count;
            mco_metadict_header_t *header;
            mco_metadict_entry_t *entry;
            const char * name = "Dict_1";
            unsigned int size;

            mco_metadict_size(10, &size); /* figure out the buffer size to
                                 register 10 database dictionaries */
            ...

            header = (mco_metadict_header_t *) malloc(size);
            mco_metadict_init(header, size); /* initialize the metadict */
            ...
            rc = mco_metadict_entry_name(header, name, &entry);

        }

### Files

Header file:
mcouda.h
Source file:
mcouda.c
Library:
libmcouda.a