Throw an exception into the generator


(PHP 5 >= 5.5.0)

Generator::throwThrow an exception into the generator

Описание

public mixed Generator::throw ( Exception $exception )

Throws an exception into the generator and resumes execution of the generator. The behavior will be the same as if the current yield expression was replaced with a throw $exception statement.

If the generator is already closed when this method is invoked, the exception will be thrown in the caller's context instead.

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

exception

Exception to throw into the generator.

Примеры

Пример #1 Throwing an exception into a generator

<?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 

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

Returns the yielded value.