FWRITEJSON¶
Category: ファイル操作
Signature¶
FWRITEJSON( path, value [, charset [, pretty]] )
Parameters¶
| Parameter | Description |
|---|---|
| path | 書き込むファイルのパス(yaya.dll からの相対パス、または絶対パス) |
| value | JSON にする値。ハッシュや配列(入れ子を含む)も1つの引数として渡せる |
| charset | ファイルの文字コード(省略可)。文字列("UTF-8" "Shift_JIS" など)または数値で指定する。省略時、または空文字列のときは UTF-8(BOM なし) |
| pretty | 1 なら改行とインデントを入れて整形する。省略時は 1(整形する) |
Returns¶
- 成功時: 1
- 失敗時: 0
Description¶
値を JSON にしてファイルに書き込む。ファイルが既にあれば上書きする。FOPEN で開いておく必要はない。
値の対応と整形の形は DUMPJSON と同じ。整形したときはファイルの末尾に改行(LF)を付ける。
書き込んだファイルは FREADJSON で読み戻せる(UTF-8 以外で書いたときは同じ charset を指定する)。
ディレクトリは作らない。存在しないディレクトリの中には書き込めない。
エラー¶
| 状況 | 警告 | GETLASTERROR |
|---|---|---|
| 引数が足りない | W0008 | 8 |
| path が文字列でない | W0009 | 9 |
| charset が不正 | W0012 / W0009 | 12 / 9 |
| ファイルを開けない | W0025 | 25 |
| 文字コードを変換できない | W0027 | 27 |
| 書き込みに失敗した | W0013 | 13 |
Example¶
_conf = IHASH()
_conf["volume"] = 80
_conf["friends"] = ("うにゅう", "まゆら")
FWRITEJSON("config.json", _conf)
// config.json:
// {
// "friends": [
// "うにゅう",
// "まゆら"
// ],
// "volume": 80
// }
FWRITEJSON("config.min.json", _conf, "", 0) // UTF-8 で1行に
Compatibility¶
- YAYA: Tc602-1以降