FWRITEJSON¶
Category: ファイル操作
書式¶
FWRITEJSON( path, value [, charset [, pretty]] )
引数¶
| Parameter | Description |
|---|---|
| path | 書き込むファイルのパス（yaya.dll からの相対パス、または絶対パス） |
| value | JSON にする値。ハッシュや配列（入れ子を含む）も1つの引数として渡せる |
| charset | ファイルの文字コード（省略可）。文字列（"UTF-8" "Shift_JIS" など。文字コードの名前）または数値で指定する。省略時、または空文字列のときは UTF-8（BOM なし） |
| pretty | 1 なら改行とインデントを入れて整形する。省略時は 1（整形する） |
戻り値¶
- 成功時: 1
- 失敗時: 0
解説¶
値を JSON にしてファイルに書き込む。ファイルが既にあれば上書きする。FOPEN で開いておく必要はない。
値の対応と整形の形は DUMPJSON と同じ。整形したときはファイルの末尾に改行（LF）を付ける。
書き込んだファイルは FREADJSON で読み戻せる（UTF-8 以外で書いたときは同じ charset を指定する）。
charset で表せない文字（Shift_JIS での絵文字など）は、JSON のエスケープ \uXXXX（BMP の外の文字はサロゲートペアの \uD83D\uDE00 のような2つ組）で書く。読み戻すと元の文字に戻る。
ディレクトリは作らない。存在しないディレクトリの中には書き込めない。
エラー¶
| 状況 | 警告 | GETLASTERROR |
|---|---|---|
| 引数が足りない | W0008 | 8 |
| path が文字列でない | W0009 | 9 |
| charset が不正 | W0012 / W0009 | 12 / 9 |
| ファイルを開けない | W0025 | 25 |
| 文字コードの変換そのものに失敗した | W0027 | 27 |
| 書き込みに失敗した | W0013 | 13 |
使用例¶
_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行に
互換性¶
- YAYA: Tc602-1以降
- Tc603-1: charset で表せない文字を、黙って
?にせず、形式のエスケープで書くようにした。知らない文字コードの名前を渡すと警告 W0012 を出して失敗するようにした（それまでは警告を出さずに OS デフォルトとして扱っていた）