Generator::throw

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

Generator::throw — Бросить исключение в генератор

Описание

publicGenerator::throw(Throwable$exception): mixed

Выбрасывает исключение в генератор и возобновляет его выполнение. Поведение будет таким, как будто текущее значение yield заменили на выражение throw $exception.

Если к моменту вызова этого метода генератор закрыт, исключение будет выброшено в контексте вызывающего кода.

Список параметров

exception: Исключение, которое надо выбросить в генератор.

Возвращаемые значения

Возвращает сгенерированное значение.

Примеры

Пример #1 Выбрасывание исключения в итератор

<?php
function gen() {
 echo "Foo\n";
 try {
 yield;
 } catch (Exception $e) {
 echo "Exception: {$e->getMessage()}\n";
 }
 echo "Bar\n";
}

$gen = gen();
$gen->rewind();
$gen->throw(new Exception('Test'));
?>

Результат выполнения приведённого примера:

Foo Exception: Test Bar