mco_metadict_entry_name

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