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 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.

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
     HCERR_OOM
     HCERR_INVALID_NVR
     HCERR_ILLEGAL_ARGUMENT