WOLFRAM

Wolfram言語 ＆ システムドキュメントセンター

ExpressionJSON (.json)

  • ImportとExportはExpressionJSONをサポートする．
  • ExpressionJSONはWolfram言語の式とJSONとの間の双方向の可逆変換を提供する．
  • デフォルトではImportとExportは「.json」で終るファイルに"ExpressionJSON"形式ではなく"JSON"形式を使用する．

予備知識

    • MIMEタイプ：application/json
    • データ交換形式．
    • ExpressionJSONはWolfram言語の式のJSON表現を与える．
    • JSONは一般にWebプログラミングに使用される．
    • JSONはJavaScript Object Notationから派生した頭字語である．
    • JSONはJavaScriptプログラミング言語のサブセットに基づく．テキスト形式．
    • JSONは2001年に開発された．
    • JSONはRFC 4627として公開された．

ImportとExport

  • Import["file","ExpressionJSON"]はExpressionJSON形式を使用するファイルをインポートし，通常のWolfram言語の式を生成する．
  • Export["file",expr,"ExpressionJSON"]は任意の式をExpressionJSONにエキスポートする．
  • 式の要素はExpressionJSONでは以下で表される：
  • "string""'string'"（JSONエスケープを使ったUTF-8）
    True, Falsetrue, false
    Nullnull
    symbol"symbol" (UTF-8)
    f[e1,e2,…,opt1val1,…]["f",e1,e2,…,["Rule",opt1,val1],…]
  • 機械整数はそのまま表される．大きい整数は"digits"で表される．
  • 機械精度数はe表記を使ってJSON数で表される．
  • 任意精度数はデフォルトでは"number"で与えられる．number は数のInputForm表現である．
  • 一般的な情報は，以下の関数ページを参照のこと．
  • Import, Exportファイルからインポートする，あるいはファイルへエキスポートする
    CloudImport, CloudExportクラウドオブジェクトからインポートする，あるいはクラウドオブジェクトへエキスポートする
    ImportString, ExportString文字列からインポートする，あるいは文字列へエキスポートする
    ImportByteArray, ExportByteArrayバイト配列からインポートする，あるいはバイト配列へエキスポートする

要素

  • 一般的なImport要素：
  • "Elements" ファイル中の有効な要素とオプションのリスト
    "Summary"ファイルの概要
    "Rules"使用可能なすべての要素の規則のリスト

オプション

  • Exportオプション
  • "Compact"False改行とタブを除外するかどうか
    "NullSymbols"{}JSON nullとして表すシンボルのリスト
    "PrecisionHandling"True大数を許可するかメッセージを発するか
  • "Compact"->n はインデントレベル n までの改行とタブを含む．

例題

例  (5)

JSONリストをインポートする：

Wolfram Language code: ImportString["[ \"List\", 1, 2, 3 ]", "ExpressionJSON"]

Stringをインポートする：

Wolfram Language code: ImportString["\"'abc'\"", "ExpressionJSON"]

Quantityをインポートする：

Wolfram Language code: ImportString["[ \"Quantity\", 2.45, \"'Meters'\"]", "ExpressionJSON"]

式をJSON文字列にエキスポートする：

Wolfram Language code: ExportString[{1, 2, 3}, "ExpressionJSON"]
Wolfram Language code: ExportString[<|"x" -> 1, "y" -> 2, "z" -> 3|>, "ExpressionJSON", "Compact" -> True]

NoneをJSON nullに変換してリストをエキスポートする：

Wolfram Language code: ExportString[{True, None}, "ExpressionJSON", "NullSymbols" -> {None}]

任意精度の数のリストをエキスポートする：

Wolfram Language code: ExportString[ <|"PlanckConstant" -> 6.626070040 * 10 ^ −34, "AvogadroConstant" -> 6.02214 * 10 ^ 23, "Pi" -> N[Pi, 20]|>, "ExpressionJSON"]

数のリストをエキスポートし，機械精度の数ではないものがあればエラーを発する：

Wolfram Language code: ExportString[<|"PlanckConstant" -> 6.626070040 * 10 ^ −34, "AvogadroConstant" -> 6.02214 * 10 ^ 23, "Pi" -> N[Pi, 20]|>, "ExpressionJSON", "PrecisionHandling" -> False]

"Compact"でインデントを制限して出力形式を制御する：

Wolfram Language code: ExportString[<|"x" -> {{1, 2}, {3, 4}}, "y" -> {{Null}}|>, "ExpressionJSON", "Compact" -> 2]