#include <dwc.h>
int DWC_AddCommonKeyValueString( const char* key,
const char* value,
char* string,
char separator );
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.
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. |
Returns the length of the character string set in 'string' (not including the NULL end-of-string character).
DWC_SetCommonKeyValueString, DWC_GetCommonValueString, DWC_SavePublicDataAsync, DWC_SavePrivateDataAsync,
2005/12/16 Initial version.
CONFIDENTIAL