ndb_cif_get_category_name_from_item_name

NAME ndb_cif_get_category_name_from_item_name

PROTOTYPE

#include "cifparse.h"

int ndb_cif_get_category_name_from_item_name(CifHandle *cf,
                                             char categoryName[MxNameLen],
                                             const char * itemName);

PURPOSE

ndb_cif_get_category_name_from_item_name extracts the category name from the complete item name itemName in the CifHandle data structure specified by cf and stores the result in categoryName, which must be of the fixed length MxNameLen. Checks are made to ensure that the extraction leads to a valid category name.

RECEIVES

cf	pointer to the CifHandle data structure
categoryName	a fixed length string to hold the category name
itemName	the name of the item from which the category name is to be extracted

RETURN VALUE

Returns the category's number or 0 upon failure.

REMARKS

See also:	ndb_cif_get_item_keyword_from_item_name