Sun Microsystems 5800 Computer Drive User Manual


 
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 modies 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 nished, 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
SynchronousCAPI Functions
SunStorageTek 5800SystemClientAPIReferenceManual June 200886