Return a pointer to a dictionary.
MCO_RET mco_metadict_entry_name( /*IN*/ mco_metadict_header_t * metadict, /*IN*/ const char * name, /*OUT*/ mco_metadict_entry_t ** entry );
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 |
This function returns a pointer to the dictionary based on its name
metadict->entries[]->name
.
MCO_S_OK | The dictionary was successfully returned |
The dictionary is not registered |
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); }