Generator::throw

(PHP 5 >= 5.5.0, PHP 7)

Generator::throw — Lance une exception dans le générateur

Description

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

Lance une exception dans le générateur et reprend son exécution. Le comportement sera le même que si l'expression yield courante ait été remplacée avec une expression throw $exception.

Si le générateur est déjà fermé quand cette méthode est appelée, l'exception sera levée dans le contexte de l'appelant à la place.

Liste de paramètres

exception

Exception à lancer dans le générateur.

Valeurs de retour

Retourne la valeur cédée.

Historique

Version Description
7.0.0 Le paramètre exception accepte également un Throwable.

Exemples

Exemple #1 >Lance une exception dans un générateur

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

L'exemple ci-dessus va afficher :

Foo
Exception : Test
Bar