Pythonイテレータとイテラブルの違いとは？初心者向けに解説

Python

最終更新2025年9月12日

リンドくん

たなべ先生、Pythonでfor文を使ってるとき、「イテレータ」とか「イテラブル」って言葉を見かけるんですけど、これって何が違うんですか？

たなべ

いい質問だね！これは多くのプログラマが混同しがちな概念なんだ。
イテラブルは「繰り返し処理できるオブジェクト」で、イテレータは「実際に繰り返し処理を行うオブジェクト」なんだよ。

Pythonでプログラミングを学んでいると、必ずと言っていいほど出会うのが「for文での繰り返し処理」ですよね。
リストや文字列を使って、要素を一つずつ処理する場面は数え切れないほどあります。

しかし、その裏で動いている「イテレータ」と「イテラブル」という仕組みについて、しっかりと理解している方は意外と少ないのではないでしょうか？

この記事では、Pythonにおけるイテレータとイテラブルの違いを、プログラミング初心者の方でも理解できるよう、具体例とサンプルコードを交えながら詳しく解説していきます。

プログラミング学習でお悩みの方へ

HackATAは、エンジニアを目指す方のためのプログラミング学習コーチングサービスです。経験豊富な現役エンジニアがあなたの学習をサポートします。

✓ 質問し放題

✓ β版公開中（2025年内の特別割引）

HackATAの詳細を見る

イテラブル（Iterable）とは何か

リンドくん

まず「イテラブル」から教えてもらえますか？なんか難しそうな名前ですけど...

たなべ

イテラブルは実はとてもシンプルな概念なんだ。 「for文で繰り返し処理ができるオブジェクト」と考えればいいよ。リスト、文字列、辞書なんかがそうだね。

イテラブルの基本概念

イテラブル（Iterable）とは、「繰り返し可能」という意味を持つオブジェクトのことです。
より具体的に言うと、for文で要素を一つずつ取り出すことができるオブジェクトを指します。

Pythonでよく使われるイテラブルには以下のようなものがあります。

リスト: [1, 2, 3, 4, 5]
文字列: "Hello World"
タプル: (1, 2, 3)
辞書: {"name": "太郎", "age": 25}
集合: {1, 2, 3, 4, 5}

実際のコード例で確認

以下のコードを見てみましょう。

# リスト（イテラブル）の例
numbers = [1, 2, 3, 4, 5]
for num in numbers:
    print(num)

# 文字列（イテラブル）の例
message = "Python"
for char in message:
    print(char)

# 辞書（イテラブル）の例
student = {"name": "田中", "age": 20, "grade": "A"}
for key in student:
    print(f"{key}: {student[key]}")

これらすべてのオブジェクトはイテラブルであり、for文で繰り返し処理を行うことができます。

イテラブルの特徴

イテラブルオブジェクトには、以下のような共通の特徴があります。

__iter__()メソッドを持っている - これがイテラブルの正式な条件です
for文で使用できる - 最も一般的な使用方法です
内包表記で使用できる - リスト内包表記などで活用できます

# イテラブルかどうかを確認する方法
from collections.abc import Iterable

print(isinstance([1, 2, 3], Iterable))  # True
print(isinstance("Hello", Iterable))     # True
print(isinstance(123, Iterable))         # False

このように、数値（123）はイテラブルではありませんが、リストや文字列はイテラブルです。

イテレータ（Iterator）とは何か

リンドくん

イテラブルは分かりました！では「イテレータ」って何が違うんですか？

たなべ

イテレータは「実際に繰り返し処理を実行するオブジェクト」なんだ。
イテラブルから作られて、要素を一つずつ取り出す仕事をしているよ。

イテレータの基本概念

イテレータ（Iterator）は、イテラブルオブジェクトから要素を一つずつ取り出すためのオブジェクトです。
言い換えると、繰り返し処理の「実行者」的な存在です。

イテレータには以下の特徴があります。

__iter__()メソッドを持つ - 自分自身を返します
__next__()メソッドを持つ - 次の要素を返します
一度しか使えない - 要素を取り出し終わると使えなくなります

`iter()`関数と`next()`関数

イテラブルからイテレータを作成するには、iter()関数を使用します。

# リストからイテレータを作成
numbers = [1, 2, 3, 4, 5]
iterator = iter(numbers)

print(type(numbers))   # <class 'list'>
print(type(iterator))  # <class 'list_iterator'>

# next()関数で要素を一つずつ取り出す
print(next(iterator))  # 1
print(next(iterator))  # 2
print(next(iterator))  # 3
print(next(iterator))  # 4
print(next(iterator))  # 5

# 要素がなくなるとStopIteration例外が発生
# print(next(iterator))  # StopIteration例外

for文の裏側で何が起きているか

実は、for文を使ったときの裏側では、以下のような処理が行われています。

# for文を使った場合
numbers = [1, 2, 3, 4, 5]
for num in numbers:
    print(num)

# 上記のfor文と同じ処理を手動で書くと
numbers = [1, 2, 3, 4, 5]
iterator = iter(numbers)  # イテラブルからイテレータを作成

try:
    while True:
        num = next(iterator)  # 次の要素を取得
        print(num)
except StopIteration:
    pass  # 要素がなくなったら終了

このように、for文は内部的にiter()とnext()を使用してイテレータを操作しているのです。

イテレータの使い回しはできない

イテレータには重要な特徴があります。
一度使い終わると、再利用できません。

numbers = [1, 2, 3, 4, 5]
iterator = iter(numbers)

# 1回目：正常に動作
for num in iterator:
    print(f"1回目: {num}")

# 2回目：何も出力されない（イテレータが使い果たされている）
for num in iterator:
    print(f"2回目: {num}")

# 再利用したい場合は、新しいイテレータを作成する必要がある
iterator = iter(numbers)
for num in iterator:
    print(f"新しいイテレータ: {num}")

イテラブルとイテレータの関係性

リンドくん

なるほど！つまりイテラブルは「材料」で、イテレータは「調理器具」みたいな感じですか？

たなべ

いい例えだね！まさにその通り。
イテラブルはデータの入れ物、イテレータはそのデータを取り出すツールという関係なんだ。

両者の関係を図で理解する

イテラブルとイテレータの関係は以下のようになっています。

# 1. イテラブル（データの入れ物）
fruits = ["apple", "banana", "cherry"]

# 2. iter()関数でイテレータを生成
fruit_iterator = iter(fruits)

# 3. next()でデータを一つずつ取り出し
print(next(fruit_iterator))  # "apple"
print(next(fruit_iterator))  # "banana" 
print(next(fruit_iterator))  # "cherry"

すべてのイテレータはイテラブルでもある

興味深いことに、すべてのイテレータは同時にイテラブルでもあります。
これは、イテレータが__iter__()メソッドを持っているためです。

from collections.abc import Iterable, Iterator

numbers = [1, 2, 3, 4, 5]
iterator = iter(numbers)

print(isinstance(numbers, Iterable))   # True（リストはイテラブル）
print(isinstance(numbers, Iterator))   # False（リストはイテレータではない）

print(isinstance(iterator, Iterable))  # True（イテレータはイテラブルでもある）
print(isinstance(iterator, Iterator))  # True（イテレータはイテレータ）

使い分け

日常のプログラミングでは、以下のような使い分けを意識すると良いでしょう。

イテラブルを使う場面

複数回繰り返し処理を行いたい場合
データを保存・管理したい場合
リスト内包表記や辞書内包表記を使う場合

イテレータを直接使う場面

メモリ効率を重視したい場合（大きなデータセットの処理）
一度だけの処理で十分な場合
カスタムイテレータを実装する場合

# イテラブル（リスト）を複数回使用
data = [1, 2, 3, 4, 5]

# 1回目の処理
total = sum(data)
print(f"合計: {total}")

# 2回目の処理（問題なく実行される）
max_value = max(data)
print(f"最大値: {max_value}")

# イテレータの場合（一度しか使えない）
data_iter = iter([1, 2, 3, 4, 5])
total = sum(data_iter)  # ここでイテレータを使い果たす
print(f"合計: {total}")

# max_value = max(data_iter)  # エラー：イテレータが空

イテラブル・イテレータの自作

リンドくん

自分でイテラブルやイテレータって作れるんですか？

たなべ

もちろん！自分で作ることで、仕組みがより深く理解できるんだよ。
特別なメソッドを実装するだけで簡単に作れるよ。

カスタムイテラブルクラスの作成

まず、自分でイテラブルクラスを作ってみましょう。数値の範囲を表すクラスを例にします。

class NumberRange:
    """指定した範囲の数値を生成するイテラブルクラス"""
    
    def __init__(self, start, end):
        self.start = start
        self.end = end
    
    def __iter__(self):
        """イテレータを返すメソッド（イテラブルの条件）"""
        return NumberRangeIterator(self.start, self.end)

class NumberRangeIterator:
    """NumberRange用のイテレータクラス"""
    
    def __init__(self, start, end):
        self.current = start
        self.end = end
    
    def __iter__(self):
        """自分自身を返す（イテレータの条件）"""
        return self
    
    def __next__(self):
        """次の値を返すメソッド（イテレータの条件）"""
        if self.current >= self.end:
            raise StopIteration
        
        value = self.current
        self.current += 1
        return value

# 使用例
my_range = NumberRange(1, 5)

# for文で使用可能
for num in my_range:
    print(f"数値: {num}")

# 複数回使用可能
print("2回目の実行:")
for num in my_range:
    print(f"再び数値: {num}")

より簡潔な実装 - ジェネレータを使用

Pythonでは、ジェネレータを使うことで、より簡単にイテラブル・イテレータを作成できます。

def number_range(start, end):
    """ジェネレータ関数による実装"""
    current = start
    while current < end:
        yield current  # yieldキーワードでジェネレータになる
        current += 1

# 使用例
my_generator = number_range(1, 5)

print(f"型: {type(my_generator)}")  # <class 'generator'>

for num in my_generator:
    print(f"ジェネレータから: {num}")

実用的な例 - ファイル行読み取りイテレータ

実際のプログラミングで役立つ例として、ファイルを一行ずつ読み取るイテレータを作ってみましょう。

class FileLineReader:
    """ファイルを一行ずつ読み取るイテラブルクラス"""
    
    def __init__(self, filename):
        self.filename = filename
    
    def __iter__(self):
        return FileLineIterator(self.filename)

class FileLineIterator:
    """ファイル行読み取り用イテレータ"""
    
    def __init__(self, filename):
        self.file = open(filename, 'r', encoding='utf-8')
    
    def __iter__(self):
        return self
    
    def __next__(self):
        line = self.file.readline()
        if not line:
            self.file.close()
            raise StopIteration
        return line.strip()  # 改行文字を除去
    
    def __del__(self):
        """オブジェクトが削除される時にファイルを閉じる"""
        if hasattr(self, 'file') and not self.file.closed:
            self.file.close()

# 使用例（ファイルが存在する場合）
# reader = FileLineReader('example.txt')
# for line in reader:
#     print(f"行: {line}")

このように、自分でイテラブル・イテレータを作成することで、特定の用途に合わせたデータ処理が可能になります。

よくある間違いと注意点

リンドくん

イテレータとイテラブルを使うときに、気をつけるべきことってありますか？

たなべ

いくつか初心者が陥りやすい落とし穴があるんだ。
特に「イテレータの使い回し」や「無限ループの作成」なんかは要注意だよ。

間違い1 イテレータを使い回そうとする

最もよくある間違いが、使い終わったイテレータを再利用しようとすることです。

# 間違った例
data = [1, 2, 3, 4, 5]
iterator = iter(data)

# 1回目の使用
result1 = list(iterator)
print(f"1回目: {result1}")  # [1, 2, 3, 4, 5]

# 2回目の使用（何も取得できない）
result2 = list(iterator)
print(f"2回目: {result2}")  # []（空リスト）

# 正しい方法 新しいイテレータを作成
iterator_new = iter(data)
result3 = list(iterator_new)
print(f"新しいイテレータ: {result3}")  # [1, 2, 3, 4, 5]

間違い2 無限イテレータで無限ループを作る

カスタムイテレータを作成する際、終了条件を適切に設定しないと無限ループになってしまいます。

# 危険な例 終了条件がないイテレータ
class InfiniteCounter:
    def __init__(self):
        self.count = 0
    
    def __iter__(self):
        return self
    
    def __next__(self):
        self.count += 1
        return self.count  # StopIterationを発生させる条件がない！

# このイテレータを使うと無限ループになる
# counter = InfiniteCounter()
# for num in counter:  # 危険：無限に続く
#     print(num)

# 安全な例 適切な終了条件を設定
class SafeCounter:
    def __init__(self, max_count):
        self.count = 0
        self.max_count = max_count
    
    def __iter__(self):
        return self
    
    def __next__(self):
        if self.count >= self.max_count:
            raise StopIteration
        
        self.count += 1
        return self.count

# 安全な使用
safe_counter = SafeCounter(5)
for num in safe_counter:
    print(f"安全なカウンタ: {num}")

間違い3 ジェネレータ式の誤解

ジェネレータ式（Generator Expression）とリスト内包表記を混同する場合があります。

# リスト内包表記（すべての要素を一度にメモリに格納）
list_comp = [x**2 for x in range(5)]
print(f"リスト内包表記: {list_comp}")
print(f"型: {type(list_comp)}")

# ジェネレータ式（必要な時に要素を生成）
gen_exp = (x**2 for x in range(5))
print(f"ジェネレータ式: {gen_exp}")
print(f"型: {type(gen_exp)}")

# ジェネレータは一度しか使えない
print(f"1回目: {list(gen_exp)}")  # [0, 1, 4, 9, 16]
print(f"2回目: {list(gen_exp)}")  # []（空）

ベストプラクティス

これらの問題を避けるためのベストプラクティスは以下の通りです。

イテレータの特性を理解する - 一度しか使えないことを意識する
適切な終了条件を設定する - カスタムイテレータでは必ずStopIteration例外を発生させる
用途に応じて選択する - 繰り返し使用する場合はイテラブル、一度だけならイテレータ
メモリ効率を考慮する - 大きなデータセットではジェネレータを活用する

実際の開発での活用場面

リンドくん

実際のプログラム開発では、どんな場面でイテレータやイテラブルが活用されるんですか？

たなべ

実はいろんな場面で使われているよ！
データベースの結果処理や大きなファイルの読み込み、API からのデータ取得なんかでも大活躍するんだ。

場面1 大きなファイルの効率的な処理

大きなログファイルやCSVファイルを処理する際、イテレータを使用することでメモリ効率的な処理が可能になります。

def process_large_file(filename):
    """大きなファイルを一行ずつ処理するジェネレータ"""
    with open(filename, 'r', encoding='utf-8') as file:
        for line_number, line in enumerate(file, 1):
            # 特定の条件でフィルタリング
            if 'ERROR' in line:
                yield {
                    'line_number': line_number,
                    'content': line.strip(),
                    'timestamp': line.split()[0] if line.split() else 'Unknown'
                }

# 使用例
# for error_info in process_large_file('application.log'):
#     print(f"エラー発見: 行{error_info['line_number']} - {error_info['content']}")

場面2 APIデータのページング処理

RESTful APIから大量のデータを取得する際のページング処理にも活用できます。

import requests
import time

class APIDataIterator:
    """API からデータをページごとに取得するイテレータ"""
    
    def __init__(self, base_url, params=None):
        self.base_url = base_url
        self.params = params or {}
        self.current_page = 1
        self.has_more_data = True
    
    def __iter__(self):
        return self
    
    def __next__(self):
        if not self.has_more_data:
            raise StopIteration
        
        # APIリクエストの作成
        current_params = self.params.copy()
        current_params['page'] = self.current_page
        
        try:
            # 実際のAPIコール（例）
            # response = requests.get(self.base_url, params=current_params)
            # data = response.json()
            
            # ここでは模擬データを返す
            if self.current_page > 3:  # 3ページで終了
                self.has_more_data = False
                raise StopIteration
                
            mock_data = {
                'page': self.current_page,
                'data': [f'item_{i}' for i in range((self.current_page-1)*10, self.current_page*10)]
            }
            
            self.current_page += 1
            time.sleep(0.1)  # API制限を考慮した待機
            
            return mock_data
            
        except Exception as e:
            self.has_more_data = False
            raise StopIteration

# 使用例
api_data = APIDataIterator('https://api.example.com/data')
for page_data in api_data:
    print(f"ページ {page_data['page']}: {len(page_data['data'])} 件のデータ")

場面3 データベースの結果セット処理

データベースから大量のデータを取得する際も、イテレータパターンが有効です。

class DatabaseResultIterator:
    """データベース結果を効率的に処理するイテレータ（模擬版）"""
    
    def __init__(self, query, batch_size=100):
        self.query = query
        self.batch_size = batch_size
        self.current_offset = 0
        self.has_more_records = True
        
        # 実際にはデータベース接続を初期化
        self.total_records = 1000  # 模擬の総レコード数
    
    def __iter__(self):
        return self
    
    def __next__(self):
        if not self.has_more_records:
            raise StopIteration
        
        # 実際にはデータベースクエリを実行
        # cursor.execute(f"{self.query} LIMIT {self.batch_size} OFFSET {self.current_offset}")
        # records = cursor.fetchall()
        
        # 模擬データの生成
        if self.current_offset >= self.total_records:
            self.has_more_records = False
            raise StopIteration
        
        end_offset = min(self.current_offset + self.batch_size, self.total_records)
        mock_records = [
            {'id': i, 'name': f'ユーザー{i}', 'email': f'user{i}@example.com'}
            for i in range(self.current_offset, end_offset)
        ]
        
        self.current_offset = end_offset
        
        if self.current_offset >= self.total_records:
            self.has_more_records = False
        
        return mock_records

# 使用例
db_results = DatabaseResultIterator("SELECT * FROM users", batch_size=50)
for batch in db_results:
    print(f"処理中のバッチ: {len(batch)} 件")
    # 各バッチを処理
    for record in batch:
        # 何らかの処理を実行
        pass

場面4 設定ファイルの動的読み込み

設定ファイルを監視して、変更があったときに自動的に再読み込みするイテレータも作成できます。

import os
import time
import json

class ConfigWatcher:
    """設定ファイルの変更を監視するイテレータ"""
    
    def __init__(self, config_file, check_interval=1):
        self.config_file = config_file
        self.check_interval = check_interval
        self.last_modified = 0
        self.current_config = None
    
    def __iter__(self):
        return self
    
    def __next__(self):
        while True:
            try:
                # ファイルの最終更新時刻をチェック
                current_modified = os.path.getmtime(self.config_file)
                
                if current_modified != self.last_modified:
                    # 設定ファイルが更新されていれば読み込み
                    with open(self.config_file, 'r', encoding='utf-8') as f:
                        new_config = json.load(f)
                    
                    self.last_modified = current_modified
                    self.current_config = new_config
                    return new_config
                
                time.sleep(self.check_interval)
                
            except FileNotFoundError:
                print(f"設定ファイル {self.config_file} が見つかりません")
                time.sleep(self.check_interval)
            except json.JSONDecodeError as e:
                print(f"設定ファイルの読み込みエラー: {e}")
                time.sleep(self.check_interval)

# 使用例（実際のファイルが存在する場合）
# config_watcher = ConfigWatcher('app_config.json')
# for config in config_watcher:
#     print(f"設定が更新されました: {config}")
#     # 新しい設定を適用する処理
#     break  # 無限ループを避けるため

これらの例からわかるように、イテレータとイテラブルの概念は、メモリ効率的で柔軟なデータ処理を実現するために、実際の開発現場で幅広く活用されています。

まとめ

リンドくん

今日はイテレータとイテラブルについて詳しく教えてもらって、ありがとうございました！
最初は難しそうに思えましたが、実際に使ってみると便利ですね。

たなべ

そう言ってもらえて嬉しいよ！
イテレータとイテラブルの理解は、効率的なPythonプログラミングの基礎なんだ。これからのプログラミングでぜひ活用してみてね！

この記事では、Pythonにおけるイテレータとイテラブルの違いについて詳しく解説してきました。
最後に、重要なポイントをまとめておきましょう。

イテラブルとイテレータの重要な違い

イテラブル：for文で繰り返し処理ができるオブジェクト（リスト、文字列、辞書など）
イテレータ：実際に繰り返し処理を実行するオブジェクト（iter()関数で作成）

覚えておきたい特徴

イテラブルは何度でも繰り返し使用できますが、イテレータは一度使うと使い果たされます
for文は内部的にiter()とnext()を使ってイテレータを操作しています
ジェネレータを使うことで、メモリ効率的なカスタムイテレータを簡単に作成できます

活用ポイント

現代のプログラミングでは、大量のデータを効率的に処理することが重要になっています。
イテレータとイテラブルの概念を理解することで、以下のようなメリットが得られます。

メモリ使用量の最適化 - 大きなデータセットでもメモリを節約できます
処理速度の向上 - 必要な分だけデータを処理するため、効率的です
柔軟なデータ処理 - カスタムイテレータで特殊な処理パターンを実装できます

これらの知識は、データサイエンスやWeb開発、システム開発など、あらゆる分野のPythonプログラミングで役立ちます。
特に、AIやデータ分析の分野では、大量のデータを効率的に処理するスキルが重要視されているため、イテレータの理解は必須と言えるでしょう。

ぜひ今回学んだ内容を実際のコードで試してみて、自分なりの活用方法を見つけてください。

この記事をシェア

Pythonイテレータとイテラブルの違いとは？初心者向けに解説

プログラミング学習でお悩みの方へ

イテラブル（Iterable）とは何か

イテラブルの基本概念

実際のコード例で確認

イテラブルの特徴

イテレータ（Iterator）とは何か

イテレータの基本概念

iter()関数とnext()関数

for文の裏側で何が起きているか

イテレータの使い回しはできない

イテラブルとイテレータの関係性

両者の関係を図で理解する

すべてのイテレータはイテラブルでもある

使い分け

イテラブル・イテレータの自作

カスタムイテラブルクラスの作成

より簡潔な実装 - ジェネレータを使用

実用的な例 - ファイル行読み取りイテレータ

よくある間違いと注意点

間違い1 イテレータを使い回そうとする

間違い2 無限イテレータで無限ループを作る

間違い3 ジェネレータ式の誤解

ベストプラクティス

実際の開発での活用場面

場面1 大きなファイルの効率的な処理

場面2 APIデータのページング処理

場面3 データベースの結果セット処理

場面4 設定ファイルの動的読み込み

まとめ

関連するコンテンツ

`iter()`関数と`next()`関数