#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,
12/16/2005 Initial version.