DWC_AddCommonKeyValueString

C Specification


#include <dwc.h>

int DWC_AddCommonKeyValueString( const char* key,
                                 const char* value,
                                 char* string,
                                 char  separator );

Description

This function adds a key/value character string to the end of a character string.

The key/value string is a string consisting of the string specified by key and the string specified by value with the separator character added as a symbol to indicate the start of the character strings.

For example, when calling this function by specifying string = "/key1/value1", key = "key2", value = "value2", and separator = '/', the character string "/key1/value1/key2/value2" is returned to string.

This is useful when creating the save data for the data storage server. See the functions DWC_SavePublicDataAsync and DWC_SavePrivateDataAsync for further information about the data storage server.

Up to 4096 characters (including the NULL end-of-string character) can be added at one time for the key/value character string.

Use the DWC_SetCommonKeyValueString when creating a key/value character string. Also, use the DWC_GetCommonValueString function to obtain the value string corresponding to a specific key string from the key/value string.

Arguments

key The pointer to the key character string to add.
value The pointer to the value character string to add.
string The pointer to the character string to which the key/value character string is being added.
separator A character used to indicate the start of each of the character strings in the key/value character string.

Return Values

Returns the length of the character string set in 'string' (not including the NULL end-of-string character).

See Also

DWC_SetCommonKeyValueString, DWC_GetCommonValueString, DWC_SavePublicDataAsync, DWC_SavePrivateDataAsync,

Revision History

12/16/2005 Initial version.