ndb_cif_move_category_by_name

NAME ndb_cif_move_category_by_name

PROTOTYPE

#include "cifparse.h"

int ndb_cif_move_category_by_name(CifHandle *cf,
                                  const char * datablockName,
                                  const char * categoryName);

PURPOSE

ndb_cif_move_category_by_name makes the current category refer to the category specified by categoryName in the datablock specified by datablockName in the CifHandle data structure specified by cf.

RECEIVES

cf	pointer to the CifHandle data structure
datablockName	identifies the datablock
categoryName	identifies the category to become the current category

RETURN VALUE

Returns the number of the current category or 0 for failure.

REMARKS

Function does provide new value to the cf.

See also:	ndb_cif_move_datablock
	ndb_cif_move_datablock_by_id
	ndb_cif_move_category
	ndb_cif_move_category_by_name
	ndb_cif_move_row
	ndb_cif_move_row_by_id
	ndb_cif_move_row_by_name