returnとyieldの違いを徹底解説：Pythonの関数設計で押さえるべきポイント

---

returnとyieldの基本を理解する：何が違うのか最初の一歩

プログラミングの世界には「return」と「yield」という2つの言葉があります。この2つは役割がまるで違うため、使い分けを正しく知ることが重要です。まずは基本を押さえましょう。
returnは関数の実行を終わらせ、結果を一度だけ返します。関数を呼ぶと、そのreturnの値が戻ってきてプログラムは次の処理へ進みます。もう少し詳しくいうと、returnは値を“一度だけ”返して関数を終了させる動作です。
対してyieldは「返す値を順番に作り出す」機能です。yieldを使った関数は「ジェネレータ」という特殊な関数になり、呼び出すとすぐに値を返すのではなく、必要になったときに次の値を計算して返す仕組みになります。つまり、yieldは「途中経過を一つずつ返す装置」と考えると理解しやすいです。
この違いを知ると、メモリの使い方や処理の流れが変わることが分かります。大量のデータを一度にメモリへ展開する必要がない場合、yieldを使うと効率が良くなることが多いです。次の段落では、具体的な仕組みと使い方を見ていきます。

まず、returnとyieldは関数の呼び出し方にも影響します。returnを使う関数は呼び出すと「値」が返って終わりですが、yieldを含む関数は「ジェネレータオブジェクト」という特殊な値を返します。これを使ってforループやイテレータで値を1つずつ取り出すことができます。もし全ての値を一度に用意してから処理したい場合はreturnを選ぶほうがシンプルです。しかし、データ量が多く、1つずつ順番に処理する必要がある場合はyieldのほうがメモリ効率が良くなることが多いです。これが大きな違いの核になります。

もう少し詳しく整理すると、returnは「結果を1回で返す」と理解すればOK、yieldは「必要な時に次の値を計算して返し、処理を一時停止して再開できる」仕組みです。これを理解すれば、どんな場面でどちらを使うべきかの判断がしやすくなります。続く段落では具体的な使い方と注意点を見ていきましょう。

この章の要点まとめ：
returnは値を一度だけ返して関数を終了、yieldは生成器として値を順番に返し、状態を保持して処理を再開できる、大量データの扱いではyieldが有利なことが多い、と覚えておくとよいです。

実用例と注意点：いつどっちを使うべきか、実戦的な判断

実際のコードを想像してみましょう。
returnを使う関数は、すぐに結果を1つ返して処理を終えます。
例1: returnを使う場合、関数はデータをまとめて返すため受け取る側は1つの値しか得られません。

def sum_to(n):
total = 0
for i in range(1, n+1):
total += i
return total

このように書くと、nが大きいとき全体の合計を一度に計算して返します。次の処理へ進む前に全ての計算が完了していなければならない点がポイントです。反対にyieldを使う場合、値を順番に生成して返せます。
例2: yieldを使う場合、関数を呼ぶとジェネレータオブジェクトが返され、forループなどで1つずつ値を取り出せます。

def squares(n):
for i in range(n):
yield i*i

このパターンでは、必要な分だけ値を順次計算して返すため、nが大きくてもメモリを大量には使いません。実務でもこの性質がとても重宝されます。次の表は両者の代表的な違いを整理したものです。

able>要点returnyield返す動作値を一度だけ返して関数を終了次の値を必要な時に返す／処理を再開できるメモリの使い方結果をすべて一括で保持することが多い値を順次生成するのでメモリ消費が少ない呼び出し方関数を呼んで値を受け取るジェネレータを作成し、forループ等で値を取り出す

実務では、データの量が未知で大きい場合やストリーム処理が必要な場合にyieldを検討します。逆に、結果を完全に整えてから返したい場合や、処理の流れを単純にすることを重視する場合にはreturnを使うのが適しています。なお、yieldとreturnを同時に使うケースもありますが、それぞれの役割を混同しないように設計することが大切です。
また、例外処理や停止条件の扱いにも注意しましょう。ジェネレータはStopIterationが内部で発生しますが、通常はforループが勝手に停止してくれます。設計時には「この関数は何を返すべきか」「いつ処理を終えるべきか」を明確にしておくと混乱を避けられます。

総括としてのコツは、データ量と処理の性質を見極めて使い分けることです。一度に全体を集約して返すならreturn、必要な分だけ順次作って返すならyieldを選ぶと、コードの読みやすさと効率のバランスがよくなります。

まとめと次の一歩

この記事で、returnとyieldの基本的な違い、実用的な使い分けの考え方、そして簡単なコード例を見てきました。ジェネレータと普通の関数の違いを正しく理解することで、データ処理の設計がぐんと広がります。実際のプロジェクトで試してみて、どの場面でどちらを使うべきか感覚を養いましょう。最後に覚えておきたいのは、Pythonの設計は「可読性」と「効率」の両立を目指すことです。returnとyield、両方の良さを使いこなせるようになると、あなたのコードは確実に進化します。

ピックアップ解説

今日は「yield」を深掘りした小ネタを一つ。実は yield は“終わりが来ても止まらないマシンのような仕組み”を生み出します。普通の関数が終わると全ての計算がそこで終わるのに対して、ジェネレータは次の値を作るための状態を内部に温存しておくので、次のループで前回の再開地点から再開できます。友達と話しているような言い方をすると、yieldは「途中で止まって、また会える約束をして戻る」ような機能です。これのおかげで、大量データを少しずつ処理するストリーム処理が自然にできるのです。

---