Descriptors

	Descriptive Text
cg_descriptor_write	Write descriptive text
cg_ndescriptors	Get number of descriptors in file
cg_descriptor_size	Get size of descriptor data
cg_descriptor_read	Read descriptive text

	Ordinal Value
cg_ordinal_write	Write ordinal value
cg_ordinal_read	Read ordinal value

Descriptive Text

Node: Descriptor_t (SIDS, File Mapping)

C Functions	Modes
ier = cg_descriptor_write (char *name, char *text);	- w m
ier = cg_ndescriptors (int *ndescriptors);	r - m
ier = cg_descriptor_read (int D, char *name, char **text);	r - m

Fortran interfaces	Modes
call cg_descriptor_write_f (name, text, ier)	- w m
call cg_ndescriptors_f (ndescriptors, ier)	r - m
call cg_descriptor_size_f (D, size, ier)	r - m
call cg_descriptor_read_f (D, name, text, ier)	r - m

Input / Ouput

ndescriptors

Number of Descriptor_t nodes under the current node.

D

Descriptor index number, where 1 ≤ D ≤ ndescriptors.

name

Name of the Descriptor_t node.

text

Description held in the Descriptor_t node.

size

Size of the descriptor data (Fortran interface only) - integer.

ier

Error status.

Note that with cg_descriptor_read the memory for the descriptor character string, text, will be allocated by the Mid-Level Library. The application code is responsible for releasing this memory when it is no longer needed by calling cg_free(text).

Ordinal Value

Node: Ordinal_t (SIDS, File Mapping)

C Functions	Modes
ier = cg_ordinal_write (int Ordinal);	- w m
ier = cg_ordinal_read (int *Ordinal);	r - m

Fortran interfaces	Modes
call cg_ordinal_write_f (Ordinal, ier)	- w m
call cg_ordinal_read_f (Ordinal, ier)	r - m

Input / Ouput

Ordinal

Any integer value.

ier

Error status.