json_encode()

Game Maker Language リファレンス > 組み込み関数 用途別 > ファイル操作・レジストリ・シェル機能・コマンドライン関連 > json_encode

json_encode †

ds_mapデータをJSON形式の文字列に変換します

構文 †

json_encode(map)

map

ds_map

戻り値 †

string

JSON文字列

説明 †

JSON (JavaScript Object Notation)はデータ交換に適した軽量なデータ形式で、可読性があり処理負荷も低いものとなります。JSONは2つの基本的なデータ構造からなっています。

• 1つはname/valueのペアからなるマップ(GameMaker:Studioでのds_map相当)
• もう1つはリスト(GameMaker:Studioにおけるds_list)

JSONはhttp_post_string()などHTTPリクエストにおける一般的なデータ形式なので、リクエストデータをds_mapに格納しておき、送信する際にjson_encodeでエンコードするのが良いでしょう。

注意点 †

現在のバージョン(2013/10/16現在 v1.2)ではJSONの階層的な構造を扱うことはできません。今後のバージョンで実装する予定です。

例 †

var hiscore_map, i, str;
hiscore_map=ds_map_create();
for (i = 0; i < 10; i += 1)
{
  ds_map_add(name[i], score[i]);
}
str = json_encode(hiscore_map);
get[0] = http_post_string("http://www.angusgames.com/game?game_id=" + string(global.game_id), str)
ds_map_destroy(hiscore_map);

上記コードはds_mapである"hiscore_map"を、"str"文字列変数にJSONで格納し、HTTPリクエストで"str"文字列をPOSTします

関連 †

• http_post_string()：POSTメソッドでHTTPリクエストを行います