Generator::throw

(PHP 5 >= 5.5.0, PHP 7)

Throw 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.

Parameters:

exception

Exception to throw into the generator.

Returns:

Returns the yielded value.

Examples:

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'));
?>

The above example will output:

Foo
Exception: Test
Bar

Links:

http://php.net/manual/en/generator.throw.php

doc_php

2025-01-10 15:47:30

Comments