GetItemExamplesCase

NAME GetItemExamplesCase

PROTOTYPE

#include "CifBuilder.h"

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

EXAMPLE

#include "CifBuilder.h"

CifBuilder cb("mmCif96.psf");

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

uWord numExamples = 0;
char ** examples = cb.GetItemExamplesCase("_atom_site.cartn_x",
                                           numExamples);

PURPOSE

GetItemExamplesCase returns an array of examples for the item itemName.

RECEIVES

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

RETURN VALUE

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

REMARKS

See also:	GetItemExamplesDetail