DWC_SetCommonKeyValueString

構文

#include <dwc.h>
int DWC_SetCommonKeyValueString(const char *key,
                                const char *value,
                                char *string,
                                char separator);

引数

key セットしたいkey文字列へのポインタ
value セットしたいvalue文字列へのポインタ
string 作成されたkey/value文字列の格納先ポインタ
separator key/value文字列の、それぞれの文字列の開始を示すための文字

返り値

stringにセットされた文字列長(ヌル文字終端は含まない)

説明

key/value文字列を作成します。

key/value文字列とは、separatorを文字列の開始を示す記号として付加し、keyで指定された文字列とvalueで指定された文字列を並べた文字列です。

例えば、key="key1",value="value1",separator='/'と指定して本関数を呼び出した場合、stringには"/key1/value1"という文字列が返されます。

データストレージサーバへのセーブデータを作成する際などに役立ちます。データストレージサーバへのセーブについては、DWC_SavePublicDataAsync/DWC_SavePrivateDataAsync関数を参照してください。

一度に作成できるkey/value文字列の文字数は4096文字(ヌル文字終端含む)までです。

この文字列に更にkey/value文字列を追加する場合は、DWC_AddCommonKeyValueString関数を使います。また、key/value文字列から、特定のkey文字列に対応するvalue文字列を取得したい場合は、DWC_GetCommonValueString関数を使います。

履歴

5.1pr2より前の変更履歴はこちら