Sun Microsystems 5800 Manuel D’Utilisation

hc_nvr_convert_to_string_arrays

Converts name-value-record to string names and string values.

hcerr_t hc_nvr_convert_to_string_arrays(hc_nvr_t *nvr,

char ***namesp,

char ***valuesp,

int *nitemsp);

This function converts a name-value-record into parallel tables of string names and string
values. This destructively modifies the name-value record and frees it, so do not call

after calling this function.

When the conversion is finished, each string in the names and values tables should be freed with
the designated deallocator (for example, free), as well as the names and values tables
themselves.

Any time there is a conversion from a double type to or from a string type, there might

be a loss of precision.

nvr

IN: The name-value-record.

namesp

OUT: Updated to point to an array of string names.

valuesp

OUT: Updated to point to an array of string values.

nitemsp

OUT: Updated to the number of active elements in the paired arrays.

HCERR_OK

HCERR_BAD_REQUEST

Synchronous C API Functions

Sun StorageTek 5800 System Client API Reference Manual • June 2008

86