JSON-python

【jsonモジュール】Pythonで「JSONファイル」を読み込む方法【load】

はじめに

Python組み込みのjsonモジュールの「load関数」を使って、JSONファイルを読み込む方法を解説します。load関数を使うと、JSONファイルを辞書に変換することができます。

Python組み込みなのでインストール不要。使い方も簡単なので、サクッとJSONを扱いたい方はぜひご覧ください。

環境

この記事は以下の環境で作成しています。

環境 バージョンなど 備考
Python 3.9.6
OS Wiindows10 Win10でもOKです。

楽天ブックス
¥1,980 (2022/09/21 10:02時点 | 楽天市場調べ)

~トレンドを知るには雑誌が最適です~

loadとloadsの違い

JSONの読み込みには「load」「loads」の2つの関数があります。読み込み対象が「ファイル」か「文字列」かで2つの関数を使い分けます。

今回はJSON「ファイル」からの読み取りなので「load関数」を使用します。

関数名 読み込み対象
load JSON「ファイル」
loads JSON「文字列」

「読み取り」となると「Parse」を思い浮かべますが、jsonモジュールにParse関数はありません。

ファイルから読み取りに使う「load」関数の使い方が知りたい方は、こちらのページをごらんください。

コードの概要

コードの概要は以下の通りです。

  • Openで「JSONファイル」を開く
  • load関数で「辞書型」として取得する
  • 辞書型データの書き換え・再表示

読み込むJSONファイル

以下のJSONファイルを読み込みます。

{
    "Email": "james@example.com",
    "Active": true,
    "CreatedDate": "2013-01-20T00:00:00Z",
    "Roles": [
      "User",
      "Admin"
    ]
}

後述するコードをそのまま実行する場合は、上記のJSONファイル(test.json)をコードと同じフォルダに保存してください。

実行結果

後述の「JSONファイルを読み込むコード」の実行結果です。JSONファイルを辞書型のデータに取り込んで表示しています。

最終行のメールアドレスは、JSONファイルの「Email」の部分を書き換えて、再表示しています。

james@example.com
True
2013-01-20T00:00:00Z
User
Admin
taro@example.com

全体コード

「JSONを読み込むコード」の全体です。ポイント部分は後述の「コードのポイント」で詳しく解説します。

import json

# JSONファイルを読み込みます
with open("test.json", "r") as file:
    dict = json.load(file)

# 読み込んだ内容にアクセス(表示)します
print( dict["Email"])
print( dict["Active"])
print( dict["CreatedDate"])

print( dict["Roles"][0])
print( dict["Roles"])

# 要素を指定して代入で、値の書き換えができます
dict["Email"] = "taro@example.com"
print( dict["Email"] )

コードのポイント

JSONファイルを開く

open関数でJSONファイルを読み込みます。

「with」の書き方はjsonモジュールに必須ではありません。スコープ(インデントされたブロック)から抜けた際に、自動的にファイルのCloseを行ってくれる便利なコードです。

「”file”という変数に、”r”(読み込みモード)で、”test.json”を開いてね」 という記述です。

with open("test.json", "r") as file:

load関数でJSONから辞書に

load関数にファイルオブジェクト(変数)を渡すと、JSONファイルを辞書型のオブジェクトとして取得できます(デシリアライズ操作)。

dict = json.load(file)

load関数は「ファイル形式」のJSONを使いますが、「文字列形式」のJSONを渡したい場合は、loads関数を使います。

dict = json.loads(string_json)

格納データにアクセスする

辞書の要素名には「”Email”」など、JSONの変数名がそのまま使われます。そのため、辞書の要素名に、JSONの変数名を指定してアクセスします。

# 読み込んだ内容にアクセス(表示)します
print( dict["Email"])
print( dict["Active"])
print( dict["CreatedDate"])

print( dict["Roles"][0])
print( dict["Roles"])

# 要素を指定して代入で、値の書き換えができます
dict["Email"] = "taro@example.com"
print( dict["Email"] )

loadのエラー対処方法

JSONファイルの内容によっては、load関数で以下のエラーが発生することがあります。その際はJSONファイルに「シングルクォート」や「カンマ忘れ」がないか確認してみてください。

シングルクォートによるエラー

JSONファイル内でシングルクォート(”)を使うと、JSONDecodeErrorが発生します。シングルクォートを使用している場合は、ダブルクォート(“”)に書き換えてください。

シングルクォートで囲んだ例
{
  'Email': 'james@example.com',
  'Active': true,
  'CreatedDate': '2013-01-20T00:00:00Z',
  'Roles': [
    'User',
    'Admin'
  ]
}
エラーの表示例
json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes: line 2 column 5 (char 6)

カンマ忘れによるエラー

JSONファイル内でカンマを忘れた場合も JSONDecodeError が発生しますエラーの行番号などを参考に、カンマ忘れがないか確認してください。

カンマを忘れた場合の例

カンマを忘れた場合の例です。先頭のEmailの行の最後にカンマがありません。

{
    "Email": "james@example.com"
    "Active": true,
    "CreatedDate": "2013-01-20T00:00:00Z",
    "Roles": [
      "User",
      "Admin"
    ]
}

エラーの表示例
json.decoder.JSONDecodeError: Expecting ',' delimiter: line 3 column 5 (char 39)

まとめ

Python組み込みの「json」モジュールを使って、JSONファイルを読み込む方法を解説しました。参考になればうれしいです。

UdemyでPythonのスキルに差をつける(無料あり)

Pythonのスキルを上げるには、Udemyの動画講座がおすすめです。

1講座 2440円程度で返金保証あり、無料講座も130本近く公開されています。アプリならオフラインで視聴できて、時間や場所にも縛られません。みんながやっていない今始めることで、スキルや評価に差をつけることができます。以下はPythonの無料講座の一覧です。

⇒ Pythonの講座一覧を見る

講座選びに迷ったらコレ

講座選びに迷ったら、以下がおすすめします。落ち着いた話し方とBGMで聴きやすく「ベストセラー」になっている講座です。

⇒ 現役シリコンバレーエンジニアが教えるPython 3 入門 + 応用 +アメリカのシリコンバレー流コードスタイル を見る

シリコンバレーの現役エンジニア酒井潤さんの講座です。基礎~応用まで盛りだくさんの講座です。シリコンバレー流の「動くだけでなく、他人も読めるコード」も一緒に学べます。

⇒ 独学で身につけるPython〜基礎編〜 を見る

京都大学・トヨタ自動車の経歴を持つ安井亮平さんの講座です。Pythonでの業務効率化方法がメインですが、Pythonの基礎から学べます。

jsonモジュールの他の使い方

このブログでは、jsonモジュールの以下の使い方についても解説しています。興味のある方は以下の記事も是非ご覧ください。

JSONファイルの読み込み

応援・要望お待ちしてます

ブログを見ていて「この辺を詳しく知りたい」「このライブラリの使い方を知りたい」「こんなことで困ってる」...etc があれば、コメント・問い合わせ・Twitterで教えてください。質問・ご要望に合わせて解説記事を作ります。

ブログを気に入っていただけたり、「応援してもいいよ」という方がいたら、ブログやSNSでの紹介をお願いします。 あたたかい応援は、中の人の更新の大きな励みになります。

ABOUT ME
えす
現役のソフトウェアエンジニアです。 C++ C# Python を使ってます。10年ちょい設計/開発部門にいましたが、今はQAエンジニアっぽいことをしています。

COMMENT

メールアドレスが公開されることはありません。