Sun Microsystems Sun StorageTek 5800 - Manual (Page 86)

hc_nvr_convert_to_string_arrays
Converts name-value-record to string names and string values.
Synopsis
hcerr_t hc_nvr_convert_to_string_arrays(hc_nvr_t *nvr,
char ***namesp,
char ***valuesp,
int *nitemsp);
Description
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
“hc_nvr_free” on page 66 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.
Note – Any time there is a conversion from a double type to or from a string type, there might
be a loss of precision.
Parameters
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.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
Synchronous C API Functions
Sun StorageTek 5800 System Client API Reference Manual • June 2008 86