Pythonの基礎

PythonでJSONを読み書きする

このレッスンでは、標準のjsonモジュールを使って、JSON文字列とPythonの辞書を相互に変換します。

  • 初級
  • 約2分で読めます
  • 実行できるサンプル 1 件

はじめに

どんな問題を解決するか

プログラムは絶えずデータをやり取りしています。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 の文字を受け取り、Python の値で作業し、JSON の文字を出します。
ひと言でいうと

JSON はデータのための文字形式です。json モジュールは JSON の文字を Python の値に(json.loads)、Python の値を JSON の文字に(json.dumps)変換します。

重要なポイント

  1. json.loads(...) は JSON の文字を Python の辞書に変え、JSON の true は True になります。
  2. user["score"] = 95 はほかの辞書と同じようにデータを書き換えます。
  3. json.dumps(user, indent=2) は人が読みやすいようにインデントを付けて JSON の文字に書き戻します。
  4. 出力では、Python の True が再び JSON の true と書かれます。

どんな場面で使う?

  • Web API からの応答を読み、データを送る。
  • 設定や小さなデータを読みやすいファイルに保存する。
  • 異なる言語で書かれたプログラムの間でデータを受け渡す。

使わなくてよいとき

  • 日付、セット、自作のクラス:JSON はそのまま保存できないので、先に文字列や辞書に変換します。
  • 巨大な数値の表:CSV やデータベースのほうが小さく速いです。

サンプルコード

コードを実行 →
main.py
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コンパイラで実行できます。

発展問題

下のヒントにしたがってコードを書き換えてみましょう。自分で変えて結果を確かめると、コードを読むだけよりずっと深く理解できます。

  1. 入力データを変え、実行する前に結果を予想してから確かめる。
  2. データが空のときや不正なときのチェックを追加する。
  3. 処理を別の関数にまとめ、いろいろなデータで試す。
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 のレビューも受けられます。

すべてのチャレンジ