Sun Microsystems 5800 manual Hcnvrconverttostringarrays

Synchronous C API Functions

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

86 Sun StorageTek 5800 System Client API Reference Manual • June 2008