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 は読み込みに利用しないでください。