Python
PR

Pythonのリスト・辞書・内包表記の基本|使い方とよくある間違いを実例で解説

Pythonのリスト・辞書・内包表記の基本|使い方とよくある間違いを実例で解説
hr
記事内に商品プロモーションを含む場合があります

Python で複数のデータをまとめて扱うときに、いちばんよく使うのがリスト(list)と辞書(dict)です。CSV の 1 行も、Web API から受け取った JSON も、Python の中ではリストや辞書になります。

この記事では、リストと辞書の基本操作、短く書ける内包表記、そして初心者がつまずきやすい「コピーしたつもりが同じものだった」「ループ中に削除したら要素が残った」などの間違いを、実行結果つきで説明します。載せている出力は、Windows 11・Python 3.12.6 で実際に実行して確かめたものです。

リスト・辞書・タプル・セットの違い

Python には、データをまとめる型が主に 4 つあります。まずは「順番で取り出すならリスト、名前(キー)で取り出すなら辞書」と覚えれば十分です。

型書き方取り出し方変更主な用途
リスト list[1, 2, 3]番号(インデックス)できる順番のあるデータの並び
辞書 dict{"name": "田中"}キーできる項目名と値の組
タプル tuple(10, 20)番号できない座標など、変えない組
セット set{"a", "b"}番号では取り出せないできる重複の除去、含まれるかの判定

以降のコードは、sample.py などの名前で保存し、PowerShell でそのフォルダーに移動してから次のコマンドで実行できます。

py sample.py

リストの基本

作成・インデックス・負のインデックス・スライス

リストは [ ] の中に値をカンマで区切って書きます。要素の番号(インデックス)は 0 から始まり、-1 は最後、-2 は最後から 2 番目を表します。[開始:終了] と書くと、一部を切り出せます(スライス)。終了の番号の要素は含まれない点に注意してください。

fruits = ["りんご", "みかん", "ぶどう", "もも", "なし"]
print(fruits[0], fruits[2])
print(fruits[-1], fruits[-2])
print(fruits[1:3])
print(fruits[:2], fruits[3:])
print(fruits[::2])
print(fruits[::-1])
print(len(fruits))
りんご ぶどう
なし もも
['みかん', 'ぶどう']
['りんご', 'みかん'] ['もも', 'なし']
['りんご', 'ぶどう', 'なし']
['なし', 'もも', 'ぶどう', 'みかん', 'りんご']
5

[::2] は 1 つおき、[::-1] は逆順です。len() で要素の数が分かります。なお、fruits[5] のように範囲外の番号を指定すると IndexError: list index out of range になりますが、スライスは範囲外でもエラーにならず、fruits[5:] は空のリスト [] になります。

追加と削除:append・extend・insert・remove・pop

nums = [3, 1, 4]
nums.append(1)
print(nums)
nums.extend([5, 9])
print(nums)
nums.insert(0, 2)
print(nums)
nums.remove(1)
print(nums)
last = nums.pop()
print(last, nums)
first = nums.pop(0)
print(first, nums)
[3, 1, 4, 1]
[3, 1, 4, 1, 5, 9]
[2, 3, 1, 4, 1, 5, 9]
[2, 3, 4, 1, 5, 9]
9 [2, 3, 4, 1, 5]
2 [3, 4, 1, 5]
書き方やること
append(x)最後に x を 1 つ追加
extend(リスト)最後に、別のリストの要素を 1 つずつ追加
insert(i, x)i 番目の前に x を追加(0 なら先頭)
remove(x)最初に見つかった x を削除(上の例では 2 つある 1 のうち前のほうだけ消えた)。なければ ValueError
pop() / pop(i)最後(または i 番目)を取り出して削除し、その値を返す

append と extend の違いは、リストを渡したときに分かります。[1, 2] に [3, 4] を append すると [1, 2, [3, 4]](リストが 1 つの要素として入る)、extend すると [1, 2, 3, 4] になります。また、extend("ab") のように文字列を渡すと、[1, 2, 'a', 'b'] と 1 文字ずつ追加されます。

ない値を remove すると、次のエラーで止まります。

ValueError: list.remove(x): x not in list

並べ替え:sort と sorted の違い

並べ替えには 2 つの方法があります。sorted(リスト) は並べ替えた新しいリストを返し、元のリストは変えません。リスト.sort() は元のリストそのものを並べ替え、戻り値は None です。

scores = [72, 95, 58, 88]
result = sorted(scores)
print(result, scores)
x = scores.sort()
print(x, scores)
scores.sort(reverse=True)
print(scores)
words = ["banana", "Kiwi", "apple", "fig"]
print(sorted(words))
print(sorted(words, key=str.lower))
print(sorted(words, key=len))
[58, 72, 88, 95] [72, 95, 58, 88]
None [58, 72, 88, 95]
[95, 88, 72, 58]
['Kiwi', 'apple', 'banana', 'fig']
['apple', 'banana', 'fig', 'Kiwi']
['fig', 'Kiwi', 'apple', 'banana']

x = scores.sort() の x が None になっている点が大事です。scores = scores.sort() と書くと、リストが None で上書きされて消えてしまいます。公式ドキュメントでも、sort は「元のリストを書き換える」ことを意識させるため、並べ替えたリストを返さないと説明されています。

文字列は文字コード順に並ぶため、大文字の Kiwi が先頭に来ます。大文字・小文字を区別せずに並べたいときは key=str.lower、長さ順なら key=len のように、key に「並べ替えの基準を作る関数」を渡します。逆順は reverse=True です。

含まれているかを調べる:in

値 in リスト で、含まれていれば True、なければ False になります。"sql" in ["Python", "SQL", "Go"] は、大文字・小文字が違うので False です。含まれていないことは not in で調べます。何番目にあるかは index()、いくつあるかは count() で分かります。

辞書の基本

作成・取得・追加・更新・削除

辞書は {キー: 値} の組を並べて作ります。値は 辞書[キー] で取り出し、同じ書き方で代入すると、キーがなければ追加、あれば上書きになります。

user = {"name": "田中", "age": 25, "lang": "Python"}
print(user["name"])
print(user.get("email"))
print(user.get("email", "未登録"))
user["email"] = "tanaka@example.com"
user["age"] = 26
print(user)
del user["lang"]
print(user)
email = user.pop("email")
print(email, user)
print(user.pop("tel", None))
print(len(user), "name" in user, "田中" in user)
田中
None
未登録
{'name': '田中', 'age': 26, 'lang': 'Python', 'email': 'tanaka@example.com'}
{'name': '田中', 'age': 26, 'email': 'tanaka@example.com'}
tanaka@example.com {'name': '田中', 'age': 26}
None
2 True False
  • get(キー) は、キーがないときにエラーにせず None を返します。get(キー, 初期値) とすると、ない場合はその値を返します
  • del 辞書[キー] は削除するだけ、pop(キー) は削除した値を返します。pop(キー, None) のように 2 つ目を渡すと、キーがなくてもエラーになりません
  • in で調べるのはキーです。値の「田中」を in で調べても False になります(値を調べるなら "田中" in user.values())

keys・values・items とループ

辞書をそのまま for で回すと、取り出されるのはキーです。キーと値を両方使うときは items() を使い、for キー, 値 in 辞書.items(): と書きます。

stock = {"りんご": 3, "みかん": 0, "ぶどう": 5}
print(stock.keys())
print(stock.values())
print(stock.items())
for name in stock:
    print(name)
for name, count in stock.items():
    print(f"{name}: {count}個")
dict_keys(['りんご', 'みかん', 'ぶどう'])
dict_values([3, 0, 5])
dict_items([('りんご', 3), ('みかん', 0), ('ぶどう', 5)])
りんご
みかん
ぶどう
りんご: 3個
みかん: 0個
ぶどう: 5個

辞書の順番は「追加した順」

Python 3.7 からは、辞書がキーを追加した順番を保つことが言語の仕様として決まっています(公式ドキュメントの「Changed in version 3.7: Dictionary order is guaranteed to be insertion order.」)。既にあるキーの値を書き換えても順番は変わらず、一度削除して追加し直したキーは最後に回ります。

d = {"b": 2, "a": 1}
d["c"] = 3
d["b"] = 20
print(d)
del d["b"]
d["b"] = 200
print(d)
print(sorted(d))
print(dict(sorted(d.items())))
{'b': 20, 'a': 1, 'c': 3}
{'a': 1, 'c': 3, 'b': 200}
['a', 'b', 'c']
{'a': 1, 'b': 200, 'c': 3}

キーの順に並べたいときは、sorted(d)(キーのリスト)や dict(sorted(d.items()))(キー順の新しい辞書)を使います。

よく使うパターン:数を数える・グループに分ける

「単語ごとの出現回数」は、get(キー, 0) + 1 で書けます。標準ライブラリの collections.Counter を使うと、多い順の取り出しまで 1 行です。

words = ["apple", "banana", "apple", "cherry", "banana", "apple"]
counts = {}
for w in words:
    counts[w] = counts.get(w, 0) + 1
print(counts)

from collections import Counter
print(Counter(words).most_common(2))
{'apple': 3, 'banana': 2, 'cherry': 1}
[('apple', 3), ('banana', 2)]

「部署ごとに名前をまとめる」ようなグループ分けは、setdefault が便利です。キーがなければ空のリストを入れてから、そのリストに追加します。

members = [
    {"name": "田中", "team": "開発"},
    {"name": "佐藤", "team": "営業"},
    {"name": "鈴木", "team": "開発"},
]
by_team = {}
for m in members:
    by_team.setdefault(m["team"], []).append(m["name"])
print(by_team)
{'開発': ['田中', '鈴木'], '営業': ['佐藤']}

この「辞書のリスト」は、JSON の配列を読み込んだときと同じ形です。JSON の中身がどんな構造になっているかを確かめたいときは、JSON 整形ツールで字下げして見ると、どこがリストでどこが辞書かが分かりやすくなります。

タプルとセット

タプルは「変更できないリスト」です。point = (10, 20) のように作り、x, y = point で一度に変数へ分けられます(アンパック)。point[0] = 99 と書き換えようとすると TypeError: 'tuple' object does not support item assignment になります。要素が 1 つのタプルは ("hello",) のようにカンマが必要で、("hello") はただの文字列です。

セットは重複を持たない集まりで、重複の除去や、含まれるかの判定に使います。

nums = [3, 1, 3, 2, 1]
print(set(nums))
print(list(dict.fromkeys(nums)))
print(type({}), type(set()))
a = {"python", "sql", "git"}
b = {"python", "go"}
print(sorted(a & b), sorted(a | b), sorted(a - b))
{1, 2, 3}
[3, 1, 2]
<class 'dict'> <class 'set'>
['python'] ['git', 'go', 'python', 'sql'] ['git', 'sql']

セットには順番の決まりがないため、元の順番を残したまま重複を消したいときは list(dict.fromkeys(nums)) を使います(辞書が追加順を保つことを利用した書き方です)。また、{} は空の辞書になるので、空のセットは set() で作ります。& は両方にあるもの、| はどちらかにあるもの、- は左にだけあるものです。文字列のセットは実行するたびに表示順が変わることがあるため、例では sorted で並べています。

内包表記で短く書く

内包表記は、「for で回して append する」処理を 1 行で書く書き方です。[式 for 変数 in 元のデータ] の形で、後ろに if 条件 を付けると、条件に合うものだけが残ります。

nums = [1, 2, 3, 4, 5, 6]
squares = []
for n in nums:
    squares.append(n * n)
print(squares)
print([n * n for n in nums])
print([n for n in nums if n % 2 == 0])
print(["偶数" if n % 2 == 0 else "奇数" for n in nums])
[1, 4, 9, 16, 25, 36]
[1, 4, 9, 16, 25, 36]
[2, 4, 6]
['奇数', '偶数', '奇数', '偶数', '奇数', '偶数']

1 行目と 2 行目は同じ結果です。後ろの if は「絞り込み」、前の A if 条件 else B は「値の切り替え」で、役割が違います。前に書く場合は else が必須です。

{ } で囲み キー: 値 と書けば辞書内包表記、キー: なしならセット内包表記になります。

words = ["apple", "Banana", "cherry"]
print({w: len(w) for w in words})
print(sorted({w.lower()[0] for w in words + ["avocado"]}))
prices = {"りんご": 120, "みかん": 80, "メロン": 980}
print({k: v for k, v in prices.items() if v < 500})
print({v: k for k, v in prices.items()})
matrix = [[1, 2, 3], [4, 5, 6]]
print([x for row in matrix for x in row])
{'apple': 5, 'Banana': 6, 'cherry': 6}
['a', 'b', 'c']
{'りんご': 120, 'みかん': 80}
{120: 'りんご', 80: 'みかん', 980: 'メロン'}
[1, 2, 3, 4, 5, 6]

最後の例のように for を 2 つ並べると、二次元のリストを平らにできます(左の for が外側のループです)。ただ、for や if が 3 つ以上になるなら、普通の for 文で書いたほうが読みやすくなります。

よくある間違いと直し方

1. b = a はコピーではない

b = a は、同じリストに別の名前を付けるだけです。b を変えると a も変わります。別のリストにするには a.copy()(または a[:]、list(a))を使います。is は「同じもの(同じオブジェクト)か」を調べる演算子です。

a = [1, 2, 3]
b = a
b.append(4)
print(a, b, a is b)
c = a.copy()
c.append(5)
print(a, c, a is c)
[1, 2, 3, 4] [1, 2, 3, 4] True
[1, 2, 3, 4] [1, 2, 3, 4, 5] False

ただし copy() は外側だけをコピーする浅いコピーです。[[1, 2], [3, 4]] のようにリストの中にリストがある場合、b = a.copy() のあと b[0].append(99) とすると、a も [[1, 2, 99], [3, 4]] に変わりました。中身まで別にしたいときは、import copy して copy.deepcopy(a) を使います。辞書の copy() も同じく浅いコピーです。

2. ループ中に要素を削除する

偶数を消すつもりで、次のように書くと 2 が 1 つ残ります。削除で後ろの要素が前に詰まり、ループが次の要素を飛ばしてしまうためです。エラーにならないので気付きにくい間違いです。

nums = [1, 2, 2, 3, 4]
for n in nums:
    if n % 2 == 0:
        nums.remove(n)
print(nums)
[1, 2, 3]

公式チュートリアルでも、ループ中にリストを変えるより「新しいリストを作るほうが簡単で安全」とされています。nums = [n for n in nums if n % 2 != 0] とすると [1, 3] になります。

辞書の場合は、ループ中に削除すると RuntimeError: dictionary changed size during iteration で止まります。for k in list(stock): のようにキーのリストを先に作ってから回すか、辞書内包表記で残すものだけの辞書を作り直します。

3. 引数の初期値にリストを書く(def f(x=[]))

def add_item(item, items=[]):
    items.append(item)
    return items

print(add_item("a"))
print(add_item("b"))
print(add_item("c"))
['a']
['a', 'b']
['a', 'b', 'c']

毎回空のリストから始まるつもりが、前回の値が残っています。公式チュートリアルに「初期値は一度だけ評価される」とあるとおり、[] は関数を定義したときに 1 回だけ作られ、呼び出すたびに同じリストが使われるためです。辞書 {} でも同じことが起きます。初期値は None にして、関数の中で作ります。

def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items

print(add_item("a"))
print(add_item("b"))

こちらは ['a']、['b'] と、毎回新しいリストになりました。

4. KeyError:ないキーを [ ] で取り出した

Traceback (most recent call last):
  ...
    print(user["email"])
          ~~~~^^^^^^^^^
KeyError: 'email'

KeyError: の後ろが、見つからなかったキーです。キーの綴りや大文字・小文字、前後の空白を確認します。データによってキーがあったりなかったりする場合は、user.get("email") や if "email" in user: で分けて書きます。

5. 二次元リストを [[0] * 3] * 3 で作る

grid = [[0] * 3] * 3
grid[0][0] = 1
print(grid)
print(grid[0] is grid[1])
grid = [[0] * 3 for _ in range(3)]
grid[0][0] = 1
print(grid)
[[1, 0, 0], [1, 0, 0], [1, 0, 0]]
True
[[1, 0, 0], [0, 0, 0], [0, 0, 0]]

1 か所だけ変えたのに、3 行すべての先頭が 1 になりました。* 3 は中のリストをコピーせず、同じリストを 3 回並べるだけだからです(公式ドキュメントでも「初心者がよく悩まされる」と注意されています)。二次元リストは、内包表記で 1 行ずつ新しいリストを作ります。なお、[0] * 3 のように中身が数値や文字列なら問題ありません。

よくある質問

辞書のキーにリストは使えますか?

使えません。{["a", "b"]: 1} は TypeError: unhashable type: 'list' になります。キーには文字列・数値・タプルのような変更できない値を使います。2 つの値の組をキーにしたいときは {("a", "b"): 1} のようにタプルにします。

リストと辞書、どちらを使えばよいですか?

「1 件のデータの項目(名前・年齢など)」は辞書、「同じ形のデータが何件も並ぶ」ならリストが基本です。社員一覧なら「辞書のリスト」になります。また、大量のデータから特定の値を何度も探す場合、リストの in は先頭から順に調べますが、辞書やセットの in はキーから直接探すため、件数が多いほど速くなります。

まとめ

  • リストは 0 から数える。-1 は最後、[開始:終了] の終了は含まない
  • sorted() は新しいリストを返し、sort() は元を書き換えて None を返す
  • 辞書のないキーは get() で安全に取り出す。キーと値のループは items()
  • b = a はコピーではない。初期値に [] を書かない。二次元リストは内包表記で作る

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました