DUMPJSON¶
Category: 型取得/変換
Signature¶
DUMPJSON( value [, pretty] )
Parameters¶
| Parameter | Description |
|---|---|
| value | JSON にする値。ハッシュや配列(入れ子を含む)も1つの引数として渡せる |
| pretty | 1 なら改行とインデントを入れて整形する。省略時は 0(1行にする) |
Returns¶
- 成功時: JSON の文字列
- 引数がないとき: 空文字列
Description¶
値を JSON の文字列にして返す。PARSEJSON の逆の変換になる。
値の対応¶
| YAYA | JSON |
|---|---|
| ハッシュ | オブジェクト。キーは文字列にする(1 は "1")。並びはハッシュのキーの順 |
| 汎用配列 | 配列 |
| 整数 | 数値。64bit の整数も誤差なく書く |
| 実数 | 数値。小数点か指数を必ず付ける(1.0、0.1、1e+300) |
| 文字列 | 文字列 |
| 空(VOID) | null |
- 整数の 1 / 0 は数値の
1/0になる。true/falseにはならない - 実数は、読み戻して同じ値になる短い表記にする。NaN と無限大は JSON で表せないので
nullになる - 文字列では
"\と制御文字(改行・タブなど)だけをエスケープする。日本語などの非 ASCII の文字や/はそのまま書く - 小数点はロケールによらず常に
.になる
整形するときは、4つの空白でインデントし、改行は LF にする。空の配列・ハッシュは [] / {} と1つにまとめる。
PARSEJSON で読み戻すと元の値に戻る。ただし、値が整数の実数(1.0)は整数になる。
エラー¶
| 状況 | 警告 | GETLASTERROR |
|---|---|---|
| 引数がない | W0008 | 8 |
Example¶
_h = IHASH()
_h["name"] = "さくら"
_h["tags"] = ("ghost", "shell")
_h["height"] = 158.5
DUMPJSON(_h)
// {"height":158.5,"name":"さくら","tags":["ghost","shell"]}
DUMPJSON(_h, 1)
// {
// "height": 158.5,
// "name": "さくら",
// "tags": [
// "ghost",
// "shell"
// ]
// }
DUMPJSON(("a", 1)) // ["a",1]
DUMPJSON(未定義の変数) // null
Compatibility¶
- YAYA: Tc602-1以降