Generator::throw

(PHP 5 >= 5.5.0, PHP 7)

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

Описание

public Generator::throw ( Throwable $exception ) : mixed

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

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

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

exception

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

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

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

Список изменений

Версия Описание
7.0.0 Теперь параметр exception также принимает Throwable.

Примеры

Пример #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