zstructPdNew

Description: Creates a new paired data struct for retrieving a paired data set.

Declaration:

zStructPairedData* zstructPdNew(const char* pathname);

Parameters:

const char* pathname

The pathname of the record to retrieve. The pathname must be exact, but is case insensitive (i.e., "Apart" is the same as "APART"), and have a correct C (independnet-dependent name) part. For example, "/Stage-Damage/", where stage is the independent parameter and Damage is the dependent.

Returns:

zStructPairedData*

An address to the paired struct created ready to be retrieved with zpdRetrieve().

Remarks:

Always call function zstructFree(struct) when finished.
Do not reuse this struct. Make a new one for every dataset.

See Also:

zpdRetrieve for use and definition of zStructPairedData.
zstructPdNewDoubles()
zstructPDsNewFloats()