Generator::throw

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

Generator::throw — 向生成器中拋入一個(gè)異常

說(shuō)明

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

拋出一個(gè)異常到生成器并恢復(fù)生成器的執(zhí)行。與當(dāng)前 yield 表達(dá)式被 throw $exception 語(yǔ)句替換是一樣的行為。

如果調(diào)用此方法時(shí)生成器已經(jīng)關(guān)閉，則將會(huì)在調(diào)用者的上下文中拋出異常。

參數(shù)

exception: 拋出異常到生成器。

返回值

返回生成的值。

范例

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

以上例程會(huì)輸出：

Foo
Exception: Test
Bar