はじめに
どんな問題を解決するか
プログラムは絶えずデータをやり取りしています。Web API がユーザー情報を送る、設定ファイルにオプションを保存する、別のプログラムがあなたの結果を待っている、などです。両者が理解できる共通の文字形式が必要で、それが JSON です。Python は JSON を辞書やリストに変換し、また元に戻す必要があります。
身近なたとえ
JSON は、どの役所でも読める決まった書式の申込用紙のようなものです。json.loads は、書かれた用紙を読み取って、扱いやすい Python のデータにします。json.dumps は、Python のデータを同じ決まった書式で書き出すので、ほかのどのプログラムでも読めます。
json.loads(...)📥 書かれた用紙を読み取って Python のデータにするuser["score"] = 95🖊️ 項目を1つ足すjson.dumps(user, indent=2)📤 決まった書式でもう一度書き出すtrue🔤 JSON の true は Python の True になるJSON はデータのための文字形式です。json モジュールは JSON の文字を Python の値に(json.loads)、Python の値を JSON の文字に(json.dumps)変換します。
重要なポイント
json.loads(...)は JSON の文字を Python の辞書に変え、JSON のtrueはTrueになります。user["score"] = 95はほかの辞書と同じようにデータを書き換えます。json.dumps(user, indent=2)は人が読みやすいようにインデントを付けて JSON の文字に書き戻します。- 出力では、Python の
Trueが再び JSON のtrueと書かれます。
どんな場面で使う?
- Web API からの応答を読み、データを送る。
- 設定や小さなデータを読みやすいファイルに保存する。
- 異なる言語で書かれたプログラムの間でデータを受け渡す。
使わなくてよいとき
- 日付、セット、自作のクラス:JSON はそのまま保存できないので、先に文字列や辞書に変換します。
- 巨大な数値の表:CSV やデータベースのほうが小さく速いです。
サンプルコード
import json
user = json.loads('{"name": "Ada", "active": true}')
user["score"] = 95
print(json.dumps(user, indent=2))
実行結果
{
"name": "Ada",
"active": true,
"score": 95
}
コードの解説
json.loads()はJSON文字列を読み取って辞書を返し、JSONのtrueはPythonのTrueになります。キーscoreを追加した後、json.dumps()が辞書をJSON文字列に戻します。引数indent=2を指定すると、結果が字下げされて読みやすくなります。
値を変更し、PythonをインストールせずにCodeUtilityオンラインPythonコンパイラで実行できます。
発展問題
下のヒントにしたがってコードを書き換えてみましょう。自分で変えて結果を確かめると、コードを読むだけよりずっと深く理解できます。
- 入力データを変え、実行する前に結果を予想してから確かめる。
- データが空のときや不正なときのチェックを追加する。
- 処理を別の関数にまとめ、いろいろなデータで試す。
よくある間違い
loads と load を混同する
loads は文字列から、load は開いたファイルから読みます。s は string の s です。
with open("user.json") as f:
user = json.loads(f)
with open("user.json") as f:
user = json.load(f)
JSON を一重引用符で書く
JSON ではキーと文字列を二重引用符で囲む必要があります。
json.loads("{'name': 'Ada'}")
json.loads('{"name": "Ada"}')
このレッスンを終えましたか?
学習済みにすると進み具合を記録できます。
チャレンジで練習する
このレッスンの内容を使って実際の問題を解きましょう。各チャレンジはブラウザで動き、すぐにテストされ、AI のレビューも受けられます。
- JSON オブジェクトを作る キーと値を JSON オブジェクト文字列に変換し、引用符とバックスラッシュを正しくエスケープします。 簡単
- フラットな JSON の数値を合計 整数を値に持つフラットな JSON オブジェクトを解析し、値の合計を求めます。 簡単