参照
本ドキュメントで使用されている表記規則
言語固有の注記
JavaScript と JSON の基本的な型の名称は、他の動的言語からの移行時には混乱を招く可能性があります。私は普段 Python プログラマーなので、ここでは Python との名称の違い、および JSON と JSON スキーマを使用する際の Python 固有のアドバイスを記しました。この本に Python の偏りを生み出そうとしているわけではありませんが、私の専門知識なので、そこから始めました。最終的には、この本があらゆるプログラマーにとって役立つことを願っています。そのため、Python の参照を Algol-68 やその他の知っている言語に翻訳することに興味のある方は、プルリクエストを歓迎します!
言語固有のセクションは、各言語のタブで表示されます。言語を選択すると、その選択はページを読み進めても保持されます。
たとえば、以下はいくつかの異なる言語で JSON を使用する際のアドバイスを示した言語固有のセクションです。
ドラフト固有の注記
JSON スキーマ標準は、いくつかの改訂版、または"ドラフト"を経ています。現在のバージョンはドラフト 2020-12 ですが、以前のドラフトも広く使用されています。
本文はドラフト 2020-12 の使用を推奨しており、最新の表記規則と機能を優先していますが、以前のドラフトとの違いについては、特別な呼び出しで強調表示されています。ドラフト 2020-12 のみを対象とする場合は、これらのセクションを無視しても問題ありません。
例
この本には多くの例があり、すべて同じ形式に従っています。各例の先頭には、特定の原則を示す短い JSON スキーマがあり、その後に、そのスキーマに対して有効または無効である短い JSON スニペットが続きます。有効な例は緑色で、チェックマークが付いています。無効な例は赤色で、バツ印が付いています。多くの場合、何かが有効であるか、または有効でないかの理由を説明するコメントが間にあります。
これらの例は、本の作成時に自動的にテストされるため、おそらく役立つだけでなく、正確であることを願っています!
これらの例は、本の作成時に自動的にテストされるため、おそらく役立つだけでなく、正確であることを願っています!
たとえば、以下は number
型の使用方法を示すスニペットです。
単純な浮動小数点数
指数表記も有効です
文字列としての数値は拒否されます
ヘルプが必要ですか?
このドキュメントは役に立ちましたか?
ドキュメントを改善するためにご協力ください!
JSON スキーマでは、他のあらゆる種類の貢献と同様に、ドキュメントへの貢献を高く評価しています!