next up previous contents
Next: GetItemLinkedChildren Up: Item Access Methods Previous: GetItemRelatedFunctionCode

GetItemSubcategories

NAME GetItemSubcategories

PROTOTYPE

#include "CifBuilder.h"

char ** CifBuilder::GetItemSubcategories(const char * itemName,
                                         uWord & n);

EXAMPLE

#include "CifBuilder.h"

CifBuilder cb("mmCif96.psf");

cb.BuildDictionaryList();
cb.SetContext("cifdic.m96");

uWord numSubcat = 0;
char ** subcategories =
 cb.GetItemSubcategories("_atom_site.cartn_x", numSubcat);
PURPOSE

GetItemSubcategories returns an array containing the subcategories that the item itemName belongs to.

RECEIVES

itemName the name of the item
n a reference to a uWord to hold the number of subcategories

RETURN VALUE

Returns the subcategory names as a char ** or NULL. The number of subcategories will be passed back via the second argument.

REMARKS

None



Olivera Tosic
6/13/2002