ゲーム百科 · データの読み方

JSONの文字列・数値・nullの違い|値の型とキーの欠落を読む

JSONの値を文字列、数値、真偽値、null、配列、オブジェクトへ分類。先頭0の識別子、大きな整数、空文字、キーがない状態を履歴の例で比較します。

約8分で読めますゲームの仕組み
種類ごとに色分けされた端末用キーボード
種類ごとに色分けされた端末用キーボード · 写真クレジット

JSONでは、"3"と3は別の種類の値です。前者は文字列、後者は数値です。画面へ並べると同じ3に見えても、記録を比較したり計算したりする段階では違いが出ます。値の見た目だけでなく、引用符と型を一緒に読むことが重要です。

履歴の識別子"001"は、先頭の0を含む文字列として保つと、その並びを照合できます。数値1へ変換すると、もともと0が二つあったという情報は残りません。数字だけでできた項目でも、計算する量なのか、名前として扱う識別子なのかで適した型が変わります。

null、空文字、0、false、キーがない状態も、同じ空欄ではありません。それぞれに異なる表現が用意されています。ここでは小さな記録を使い、JSON自体が決める構造と、項目の意味を決めるデータ仕様を分けて確認します。

JSONの値は六つの種類へ分けられる

JSONには文字列、数値、真偽値、null、配列、オブジェクトがあります。キーと値を組にしたオブジェクトでは、キーは文字列で、値にはこれらの種類を置けます。

JSONの値種類読み方
"001"文字列三つの文字を保つ
3数値数として扱う
true / false真偽値二つの論理値
nullnull明示されたnull値
[1,2]配列順序を持つ値の列
{"a":1}オブジェクト名前と値の組

キーと値は別の役割

{"count":3}なら、countがキー、3が値です。コロンは二つの対応を示し、二重引用符で囲まれたキーを数値へ変換して読むものではありません。名前が同じでも、値の型が異なれば記録の扱いが変わる場合があります。

キーの名前だけから単位や意味を確定できるとは限りません。valueという名前の3が点数か秒数かは、別の説明が必要です。JSONは構造を表す形式であり、業務上の意味を自動で補う辞書ではありません。

真偽値は文字ではない

trueとfalseは、引用符を付けず小文字で書く真偽値です。"false"は文字列なので、同じものではありません。説明文のfalseという語と、状態を表す真偽値を混同しないようにします。

プログラムによっては空でない文字列を条件式で真として扱います。そのため文字列"false"を真偽値falseのつもりで渡すと、意図と逆の判断になる場合があります。見た目の語を信じず、型を確認する理由の一つです。

配列とオブジェクトも値になる

[1,2,3]は順序を持つ配列、{"status":"done"}は名前と値の組を持つオブジェクトです。値の内部へさらに値を入れられます。平らな表へ表示する場合も、内部の構造を勝手に一つの文字列と同一視しません。

nullは他の五つへ含めず、独立した値として読みます。JavaScriptの一部の型確認でnullがobjectと出る事情がありますが、JSONを説明するときにnullとオブジェクトを同じ種類として扱う必要はありません。

JSONの値の種類を区別する
入力はブラウザ内で解析します。実際の個人情報や認証情報は入力しないでください。 図は横にスクロールできます。
多数の機能キーを備えたIBMの端末用キーボード
多数の機能キーを備えたIBMの端末用キーボード · https://www.flickr.com/people/lonelyfox/ / CC BY 2.0 · 写真クレジット

引用符の内側は、数字でも文字列

文字列は二重引用符で囲みます。数字、日時、状態名などが入っていても、JSONとしての種類は文字列です。内容の形式と値の型を分けて考えます。

先頭0を含む識別子

"001"と"1"は文字列として違います。識別子の仕様が三桁固定なら、この違いが照合に必要です。数値へ変換して両方を1へすると、元の区別を失います。計算しない番号を、見た目だけで数値へ変えないことが大切です。

JSONの数値では001という表記は認められません。先頭0を持つ並びを保持したいなら文字列を使います。数値へ変換してから三桁表示を付け直しても、元の桁数を知っていたことにはならず、表示規則を新たに適用した状態です。

空文字と空白も違う

""は長さ0の文字列です。" "は空白一つを持つ文字列なので、同じ値ではありません。画面でどちらも何もないように見えても、比較や長さの判定では違いが出ます。空白を削る処理の有無も確認します。

文章の前後の空白に意味がある場合もあります。すべての文字列を一律に整形すると、元の記録を変えることがあります。項目の仕様に合わせて扱い、見やすくするための表示変更と保存する値を区別します。

エスケープは文字の表し方

文字列の中で引用符や改行を表すには、エスケープを使います。例えば「\n」は、JSON文字列内で改行を表す書き方です。バックスラッシュとnの二文字をそのまま見せたい場合とは、必要な表記が違います。表示された文章と元のJSONテキストを分けて確認します。

日本語は直接書くことも、対応するUnicodeのエスケープで表すこともできます。表記の形が違っても、解析後の文字列が同じ場合があります。逆に見た目が似ていても別の文字の場合もあり、照合は目的に合った規則で行います。

JSONオブジェクトのキーと値の種類を見る

小さなJSONオブジェクトを解析し、最上位のキー、値、種類を表示します。数値精度への注意とnullの存在を確認できます。

入力値を確かめる準備ができました。

入力はブラウザ内で解析します。実際の個人情報や認証情報は入力しないでください。

数値の書き方と、受け手の精度は別の問題

JSONの数値には整数、小数、指数表記があります。一方、受け取ったプログラムがどの精度で保持するかは実装にも関わります。構文として読めることだけで精度は保証されません。

表現JSONでの種類注意点
"001"文字列先頭0を保持
001有効な数値表記ではない複数桁の数値で先頭0を認めない
2e3数値値は2,000
"2e3"文字列指数を計算しない
9007199254740993数値通常のJavaScript解析で精度に注意
"9007199254740993"文字列識別子の桁を保持できる

指数表記も数値

2e3は2×10の3乗を表す数値で、値は2,000です。"2e3"なら文字列です。引用符の有無に加え、指数表記が計算上の値へなることを確認します。元の表記を厳密に保存したい用途では、値と表記の違いも重要です。

1と1.0はJSONテキスト上の書き方は違いますが、解析後に同じ数値として扱われる場合があります。小数点以下の桁数を測定精度として残したいなら、その意味を別に持たせる必要があります。数値だけから表示桁を復元できるとは限りません。

大きな整数は丸められる場合がある

JavaScriptの通常のNumberでは、すべての大きな整数を一つずつ区別できるわけではありません。安全な整数の範囲を超えた識別子を数値で読むと、元の数字列と違う値へ丸められる場合があります。表示された数字だけでは元へ戻せません。

9,007,199,254,740,993という整数を通常のJSON解析へ渡すと、JavaScriptでは9,007,199,254,740,992になる例があります。識別子を文字列"9007199254740993"として保てば、その桁の並びを維持できます。用途に合わせて型を選びます。

小数も常に厳密とは限らない

二進の浮動小数点では、0.1などの十進小数を厳密に表せない場合があります。JSONで0.1と書けることと、計算過程で十進数として完全な精度を持つことは違います。丸め方が必要な計算では、データの仕様も確認します。

NaNやInfinityという名前はJSONの数値として書けません。非常に大きな指数表記を解析できても、受け手の表現範囲を超える問題が残ります。形式の有効性と、目的の数を正しく扱えることを別々に確認します。

画面と専用キーボードを組み合わせた情報端末
画面と専用キーボードを組み合わせた情報端末 · Science Museum Group / CC BY-SA 4.0 · 写真クレジット

nullと、キーがない状態を区別する

{"note":null}にはnoteというキーが存在し、値がnullです。{}にはnoteがありません。二つを同じ空欄へ見せると、元の区別が分からなくなります。

存在するがnullという記録

nullは明示的な値です。何を意味するかは仕様によります。未入力、該当なし、未確定などへ使われる場合がありますが、JSONの形式だけではどれかを決められません。nullを見ただけで未処理と断定しないようにします。

キーがあることを確認してから値を読むと、欠落と分けられます。画面の一覧へ空欄を置く場合も、元がnullだったのかキーなしだったのかを、内部の記録として保持すると照合しやすくなります。

0とfalseは実際の値

countが0なら、数値0という値があります。activeがfalseなら、真偽値falseという値があります。空欄へまとめる表示は、件数がゼロという情報や、状態が偽という情報を失う場合があります。

値が真らしいかどうかだけで存在を判断すると、0、false、空文字などを欠落と取り違える場合があります。キーの存在と値の比較を別に行う必要があります。どの値を有効とするかは、項目ごとの仕様へ合わせます。

undefinedはJSONの値ではない

JavaScriptにはundefinedがありますが、JSONでその名前を値として書くことはできません。キーがない状態を説明する際に、JSONテキストへundefinedをそのまま入れると構文が変わります。形式と利用言語の値を分けます。

JavaScriptの値をJSONへ変換するとき、undefinedを含む項目の扱いは置かれた場所によって変わる場合があります。変換後のテキストを確認し、元のオブジェクトと同じ情報が残ったかを確かめます。自動変換を無条件に同一視しません。

配列の順序と、オブジェクトのキーを分ける

配列は順番を持つ値の列です。オブジェクトは名前で値を対応させます。記録の順序を持たせたいなら、どの構造がその順序を表すのかを明確にします。

配列の位置には意味がある

["A","B"]と["B","A"]は、順序が違う配列です。履歴の列として使うなら、この違いが重要になります。ただし配列に入っていることだけで、必ず時刻順と保証されるわけではありません。並びの仕様を確認します。

配列には種類の違う値を混ぜられますが、実際のデータ仕様がそれを許すとは限りません。JSONとして有効なことと、項目の型が期待通りであることを分けます。形式の解析が成功しても、値の検証は残ります。

キーの順番へ履歴を任せない

オブジェクトはキーと値の対応を表すため、受け手が項目の列挙順へ依存すると互換性の問題が生じます。状態の推移を表したいなら、単にキーを書いた順を時間順の根拠にしないようにします。

実際のプログラムが一定の順で表示していても、その順がデータ仕様の意味とは限りません。時刻や連番を持つ配列など、順序を表す情報を使います。画面の並びと記録の意味を分けて確認することが大切です。

同じキーを重ねない

一つのオブジェクトに同じ名前が複数あると、受け手によって扱いが違う場合があります。最後の値だけを残す実装もあり、テキストに書いた二つの値を両方保つとは限りません。キーの一意性を保つことが必要です。

解析後の一覧に一つしか見えないから、元のテキストにも一つしかなかったと断定できません。重複キーの検査と、解析後の型を表示する例は別の機能です。元のJSONの構造も、必要に応じて確認します。

文字キーと数字キーを備えた通信端末
文字キーと数字キーを備えた通信端末 · Cory Doctorow from Beautiful Downtown Burbank, USA / CC BY-SA 2.0 · 写真クレジット

構文が正しくても、項目の意味はまだ確認が必要

JSONとして読めることは、括弧や引用符の規則に合うという確認です。値の範囲や状態名が正しいかは、別の仕様へ照らす必要があります。

文字列なら何でも状態名になるわけではない

statusが文字列であっても、許される値がpendingとdoneだけなら、"orange"は期待した状態ではありません。型の確認と、値の候補の確認は異なる段階です。どちらか一方で全部を検証したと考えないようにします。

countが数値でも、負の値や小数を許すかは項目の意味によります。JSON自体には件数は非負整数という規則はありません。形式が扱える数の範囲と、用途が受け入れる範囲を分けて考えます。

型を勝手にそろえない

文字列"3"を数値3へ変える処理は、意味を持った変換です。数を表す入力なら必要な場合がありますが、識別子なら不適切な場合があります。すべての数字らしい文字列を自動で数へする方法は、情報を失う原因になります。

逆に数値を文字列へする場合も、元の表示桁や指数表記が戻るとは限りません。解析して得た値を再び文字へする操作と、元のJSONテキストをそのまま保存する操作を区別します。必要な情報へ合わせて保持します。

文字の正しさは別の確認

JSONの記号が正しく読めても、値の日本語が文字化けしていることはあります。構文の成功だけを文字の内容の保証にしません。短い既知の語と値の型を、それぞれ確認すると違いを見つけやすくなります。

同じように、形式が有効な日付文字列でも、存在しない日付を入れられる場合があります。JSONのstringという種類は、日時としての妥当性まで含みません。値の型と、その中の形式や意味を段階的に読みます。

小さなオブジェクトから、キーと型を確認する

操作例では最上位をJSONオブジェクトにし、各キーの値と種類を並べます。実際の個人情報や認証情報ではなく、短い架空の記録で違いを確かめます。

初期例の四つを読む

{"round":"001","count":3,"active":true,"note":null}では、roundが文字列、countが数値、activeが真偽値、noteがnullです。見た目の列ではなく、引用符と値の規則からそれぞれを分類できます。

roundを数値1へ変えると、型と先頭0の情報が変わります。activeを"true"へ変えると、真偽値から文字列へ変わります。一度に一つの項目を変えれば、出力のどこが変わったかを確認しやすくなります。

noteを削除してnullと比べる

noteをnullのままにした場合は、そのキーが一覧へ現れます。項目ごと削除した場合は一覧へ現れません。空文字へ変えれば、文字列として存在します。三つの状態を並べると、同じ空欄ではないことが分かります。

この例が表示するのは最上位の値です。入れ子の中のすべての項目を自動で検査する機能ではありません。配列やオブジェクトが値になった場合、内部の意味や型の条件は別に確認します。

精度の注意を元テキストと比べる

大きな整数を数値で入れる場合は、元の数字列と解析後の表示を比較します。注意表示が出るときも、すでに解析で丸められた値を見ている可能性があります。注意が元の整数を復元する機能だとは考えません。

すべての小数計算の誤差や、重複キーを完全に検査する道具ではありません。値の種類を学ぶ入口として使い、必要な検証を区別します。キー、型、値、意味という順に見ると、見た目だけで情報を取り違えにくくなります。

かな文字と機能キーを備えた電報入力装置
かな文字と機能キーを備えた電報入力装置 · 写真クレジット

よくある質問

"3"と3は同じですか。

文字列と数値という別の種類です。画面では似て見えても、比較や計算で扱いが違う場合があります。計算する量なのか、数字を含む識別子なのかを確認し、引用符の有無だけでなく項目の意味も見ます。

先頭0の番号は数値へしますか。

識別子として桁の並びを保つなら文字列が適しています。"001"を数値1へ変えると先頭0の情報が消えます。JSONの数値として001という表記は使えないので、表示したい並びと型を分けます。

nullはキーがない状態と同じですか。

違います。{"note":null}にはnoteがあり、{}にはありません。nullの意味が未確定か該当なしかは仕様によります。JSONの形式だけでは決まらないため、キーの存在と値を別々に確認します。

falseと"false"は同じ意味ですか。

JSONでは真偽値と文字列の違いがあります。プログラムが文字列を条件式でどう扱うかによって、意図と違う判断になる場合もあります。語の見た目を真偽値へ読み替えず、型を確認します。

大きな整数を数値で保存すると何が起きますか。

通常のJavaScriptのNumberでは、安全な整数範囲を超えると丸めが起きる場合があります。識別子なら文字列として桁を保つ方法があります。構文として読めることと、元の整数が正確に残ることは別です。

JSONが解析できれば値も正しいですか。

構文が有効でも、状態名や数値範囲が用途の仕様に合うとは限りません。文字列の中の日時や日本語の内容にも別の確認が必要です。型、許される値、意味をそれぞれ照合します。

同じキーを二つ書いても両方残りますか。

保証できません。最後の値だけを残す実装などがあり、受け手によって扱いが異なります。キーを一意にすることが重要です。解析後の型一覧は、元テキストの重複を完全に検査する機能とは違います。

型を確認する例は入れ子も全部検証しますか。

最上位のオブジェクトの各値を表示する例です。内部の全項目や用途の仕様を自動検証しません。数値精度の注意も元の数字を復元する機能ではないので、元のテキストと解析後の値を比較します。