Load from the File (TEXT)
JSON をファイルからロード
ASTER::ACTION::JSON
::Load JSON
JSON ファイルをロードします。
パスを指定して JSON を読み込み、「パース処理」によって ASTER からデータを呼び出せる形式に変換します。
正常な JSON データによって適切にパースが行われた場合のみ、呼び出し可能なデータがメモリに展開されます。
パラメータ.1
e.g. “./json/sandbox/00.json” » カレントディレクトリ以下 json/sandbox というディレクトリにある 00.json をロードします.
パースに失敗した場合、例外発生 ( Exception )、メッセージを表示、処理を直ちに終了します。
指定したパスにファイルが存在しない場合、エラーメッセージを表示、処理を直ちに終了します。
注意点.1
読み込み時のエラーや例外処理が発生した時点で、前回ロードしたパース済み JSON データがメモリにあった場合、自動的にポインタ情報を失い、前回データを呼び出せなくなり再ロードが必要になります。
注意点.2
不正な JSON データが読み込まれた場合、例外が発生します。データ形式に不備があるとパースエラー、保存された文字エンコーディングが UTF-8 以外の場合にもパースエラー。
注意点.3
BOM ( バイト・オーダー・マーク ) 付き UTF-8 形式 について。
Windows 環境で主に活用されるデータ形式です。RFC 8259 では UTF-8 に BOM 追加を認めていません。
https://www.asahi-net.or.jp/~ax2s-kmtn/internet/rfc8259j.html
ただし、本エクステンションで利用される場合のみ、現在は BOM 付き UTF-8 をロードしてもパースエラーは発生しません。
正式にサポートはしていないので BOM 付き UTF-8 は読み込みに利用しないでください。