Documentation Python

Pythonのcollectionsモジュールとは？

Pythonの標準ライブラリcollectionsモジュールは、便利で効率的なデータ構造を提供するパッケージです。標準のリストや辞書よりも特定のユースケースに適した構造が多数揃っており、データ操作の効率を大幅に向上させます。このモジュールの中でも特に役立つdefaultdict、Counter、namedtupleについて、具体的な使い方を解説します。

defaultdict - デフォルト値を持つ辞書

defaultdictとは？

defaultdictは、通常の辞書と似ていますが、異なる点は、キーが存在しない場合に自動的にデフォルト値を生成できることです。通常の辞書では、存在しないキーにアクセスしようとするとKeyErrorが発生しますが、defaultdictを使うとその問題を回避できます。

基本的な使い方

from collections import defaultdict
# デフォルト値を0に設定した辞書
dd = defaultdict(int)
dd['apple'] += 1
dd['banana'] += 2
print(dd)  # 出力: defaultdict(<class 'int'>, {'apple': 1, 'banana': 2})

この例では、キーが存在しなくてもint型（デフォルトで0）の値が自動的に設定され、KeyErrorが発生しません。

よく使われるユースケース

文字列やリスト内の要素のカウントなど、要素の集計処理でよく使われます。リストを格納するdefaultdictも簡単に作成できます。

dd = defaultdict(list)
dd['fruits'].append('apple')
dd['fruits'].append('banana')
print(dd)  # 出力: defaultdict(<class 'list'>, {'fruits': ['apple', 'banana']})

この場合、キー'fruits'が存在しないときは自動的に空のリストが作成されます。

Counter - 要素の出現回数を数える

Counterとは？

Counterは、要素の出現回数を数えるために設計されたデータ構造です。リストや文字列などのイテラブルを渡すと、それぞれの要素が何回出現したかを簡単に集計できます。

基本的な使い方

from collections import Counter
# 文字列内の文字の出現回数を数える
counter = Counter("applebanana")
print(counter)  # 出力: Counter({'a': 4, 'p': 2, 'l': 1, 'e': 1, 'b': 1, 'n': 2})

Counterは、与えられたデータ内の要素を自動的に数えて、辞書のような形式で結果を返します。ここでは、文字'a'が4回出現していることがわかります。

Counterの便利なメソッド

  1. most_common()
    出現回数が多い順に要素を取得できます。

    print(counter.most_common(2))  # 出力: [('a', 4), ('p', 2)]

  2. update()
    新しい要素を追加してカウントを更新することができます。

    counter.update("banana")
print(counter)  # 出力: Counter({'a': 6, 'p': 2, 'l': 1, 'e': 1, 'b': 2, 'n': 4})

  3. subtract()
    出現回数を減らすことも可能です。

    counter.subtract("apple")
print(counter)  # 出力: Counter({'a': 3, 'p': 1, 'l': 0, 'e': 0, 'b': 2, 'n': 4})

namedtuple - 名前付きタプル

namedtupleとは？

namedtupleは、通常のタプルに名前付きフィールドを追加したものです。通常のタプルは位置ベースで値にアクセスしますが、namedtupleを使うと、フィールド名を使って値にアクセスできます。これにより、可読性とコードの明瞭さが向上します。

基本的な使い方

from collections import namedtuple
# Pointという名前付きタプルを作成
Point = namedtuple('Point', ['x', 'y'])
p = Point(10, 20)
print(p.x)  # 出力: 10
print(p.y)  # 出力: 20

この例では、Pointという名前付きタプルを作成し、xとyというフィールド名を使って値にアクセスしています。通常のタプルのように位置で値を取得することもできますが、フィールド名を使う方が明確でエラーが少なくなります。

namedtupleの利点

  1. 可読性の向上
    フィールド名を使うことで、どの値が何を意味しているのかがはっきりします。
  2. 軽量なオブジェクト
    namedtupleは通常のタプルと同様にメモリ効率が良く、オーバーヘッドが少ないです。

よく使われるユースケース

名前付きタプルは、軽量なデータ構造を使いたい場面で役立ちます。特に、複数の値を1つのオブジェクトとして扱いたいが、クラスを定義するほどではない場合に便利です。

# 複数の座標点を扱う例
Point = namedtuple('Point', ['x', 'y'])
points = [Point(1, 2), Point(3, 4), Point(5, 6)]
for p in points:
    print(f"Point({p.x}, {p.y})")

deque - 両端で効率的な操作ができるキュー

dequeとは？

deque（double-ended queue）は、リストのようなデータ構造ですが、両端での追加や削除が高速に行えるように設計されています。通常のリストでは、要素を先頭に追加・削除する操作は非効率的ですが、dequeはこれを効率よく処理できます。

基本的な使い方

from collections import deque
# dequeの作成
d = deque([1, 2, 3])
d.append(4)  # 末尾に追加
d.appendleft(0)  # 先頭に追加
print(d)  # 出力: deque([0, 1, 2, 3, 4])
d.pop()  # 末尾の要素を削除
d.popleft()  # 先頭の要素を削除
print(d)  # 出力: deque([1, 2, 3])

dequeを使うことで、リストの先頭や末尾での要素の追加・削除を効率よく行うことができます。

まとめ

Pythonのcollectionsモジュールは、効率的で柔軟なデータ構造を提供し、日常的なデータ操作を簡単に行 えるようにします。特に、defaultdictはデフォルト値を持つ辞書として、Counterは要素のカウントに、namedtupleは名前付きフィールドを持つ軽量なデータ構造として役立ちます。これらのデータ構造を使いこなすことで、Pythonプログラムの効率と可読性が大幅に向上します。

参照:

`Python`公式ドキュメント - collectionsモジュール
円