Generator::throw

(PHP 5 >= 5.5.0, PHP 7)

Generator::throw — Lanzar una excepción dentro generador

Descripción

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

Lanza una excepción dentro del generador y reanuda su ejecución. El comportamiento será el mismo que si la expresión yield actual fuera reemplazada con una sentencia throw $exception.

Si el generador ya está cerrado al invocar a este método, la excepción será lanzada en su lugar en el contexto del invocador.

Parámetros

exception: La excepción a lanzar dentro del generador.

Valores devueltos

Devuelve el valor generado.

Historial de cambios

Versión	Descripción
7.0.0	Ahora el parámetro `exception` también acepta Throwable.

Ejemplos

Ejemplo #1 Lanzar una ecepión dentro de un generador


<?php
function gen() {
    echo "Foo\n";
    try {
        yield;
    } catch (Exception $e) {
        echo "Excepción: {$e->getMessage()}\n";
    }
    echo "Bar\n";
}
 
$gen = gen();
$gen->rewind();
$gen->throw(new Exception('Prueba'));
?>

El resultado del ejemplo sería:

Foo
Excepción: Prueba
Bar