yield from 文や send() メソッドに加えて、ジェネレータを使う際にあまり利用されていない機能として throw() メソッドがあります。


ジェネレータが throw() メソッドによって呼び出されると、再開した時点の、すなわち、前回終了した時点の yield 式自体が渡された例外を即座に投げます。


そして、ジェネレータ内でその例外をキャッチしない場合、呼び出し元にその例外を投げてジェネレータはその時点で動作を終了します。





yield 2 で停止していたジェネレータを throw(MyError()) メソッドで再開しましたが、
ジェネレータ内ではこの例外をキャッチしていないので、yield 3 を実行することなく例外を投げて終了しています。


しかし、例外を発生させる yield 式を try / except ブロックで囲んでジェネレータ内部でその例外をキャッチした場合は、
例外を発生させてから次の yield 式まで実行して値を返すか、返す値が存在していなければ StopIteration 例外を投げます。





ねっ、yield 2 で停止していたジェネレータを throw(MyError()) メソッドで再開、例外がキャッチされてエラーメッセージが表示され、次の yield 4 が実行されて停止しています。
もし yield 4 ステートメントがなければ StopIteration 例外が発生しますので試してください。


ここまで見てきたように、send() メソッドと同様、throw() メソッドを利用してもジェネレータと双方向コミュニケーションを築くことができる、ということなんです。


例えば、渡された数値からのカウントダウン値を返すジェネレータ関数があり、外部の他の関数の結果によってそのカウントダウンを続行したりリセットしたりするようなプログラムを throw() メソッドを利用して記述してみましょう。





期待通りに動作していますね。
でも、run_with_throw() 関数のネストが深めでちょっと読み辛くはありませんか？


ジェネレータを next() で呼び出すのか、それとも throw() で呼び出すのか判断して、
カウントダウンが終了したかどうか StopIteration 例外をキャッチできるようにして、
StopIteration 以外のときはカウントダウン文字列を出力して。


これと同じ機能を実現するもっとスマートな方法はイテラブル可能なコンテナクラスを定義してしまうことです。





throw() メソッドを利用したバージョンとまったく同じ結果が得られました。
run_with_container() 関数の読み易さはいかがでしょうか？ ちょっとスッキリしていて分かりやすくはないですか？


１つだけ注意していただきたいのは、リセットがかかった場合の処理です。


throw() メソッドを利用したバージョンでは、カウント数をリセットし、while ループの先頭に戻ってカウント数を -1 し、yield 文でその値を出力して停止します。


ですから、コンテナクラスバージョンでも同様の処理を再現するために、元のカウントダウン数 (self.count) を -1 して self.current にセットし、その値を返すようにしています。


まとめ：

1: throw() メソッドを利用することで、ジェネレータ内で例外を発生させることが可能になります。この例外は前回のイテレート動作が終了した時点の yield 式で発生します。

2: throw() メソッドを利用する場合は例外処理や条件分岐を記述せざるを得ず、ネストが深くなり読解性が落ちやすくなります。

3: throw() メソッドを利用した場合と同様の機能を実現するより良い方法は、例外発生時の状態遷移を模倣する関数と __iter__() メソッドを実装したコンテナクラスを記述することです。