json

JSONファイルから構造化データを読み込む。

読み込むファイルにはオブジェクトや配列などの有効なJSON値が含まれていなければなりません。 JSONの値は、下の表に示す対応するTypstの値に変換されます。

この関数は辞書、配列、あるいはJSONファイルの内容に応じた別のJSONデータ型を返します。

この例におけるJSONファイルは、 temperature、unit、およびweatherというキーを持つオブジェクトを含んでいます。

例

#let forecast(day) = block[
  #box(square(
    width: 2cm,
    inset: 8pt,
    fill: if day.weather == "sunny" {
      yellow
    } else {
      aqua
    },
    align(
      bottom + right,
      strong(day.weather),
    ),
  ))
  #h(6pt)
  #set text(22pt, baseline: -8pt)
  #day.temperature °#day.unit
]

#forecast(json("monday.json"))
#forecast(json("tuesday.json"))

変換の詳細

注意事項

• 多くの場合、JSONの数値は整数か小数かに応じてfloatまたはintに変換されます。 ただし、2⁶³-1より大きい（または-2⁶³より小さい）整数は 浮動小数点数に変換されるため、近似値になる可能性があります。

• bytesは性能と可読性のためJSON配列としてはエンコードされません。 バイナリデータにはcbor.encodeを検討してください。

• repr関数はデバッグ目的のみで、 出力の安定性はTypstのバージョン間で保証されません。