Generator::send

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

    Generator::send — Sendet einen Wert an einen Generator

    Beschreibung

    publicGenerator::send(mixed$value): mixed

    Sendet den angegebenen Wert als Ergebnis des aktuellen yield-Ausdrucks an den Generator und setzt die Ausführung des Generators fort.

    Wenn sich der Generator beim Aufruf dieser Methode noch nicht bei einem yield-Ausdruck befindet, kann er zunächst zum ersten yield-Ausdruck vorrücken, bevor er den Wert sendet. Daher ist es bei einem PHP-Generator nicht nötig, ihn mit einem Generator::next()-Aufruf "vorzubereiten" (wie es bei Python der Fall ist).

    Parameter-Liste

    value

    Der Wert, der an den Generator gesendet werden soll. Dieser Wert ist dann der Rückgabewert des yield-Ausdrucks, bei dem der Generator gerade steht.

    Rückgabewerte

    Gibt den gelieferten Wert zurück.

    Beispiele

    Beispiel #1 Werte mittels Generator::send() einfügen

    <?php
    function printer() {
    echo     "I'm printer!".PHP_EOL;
    while (    true) {
    $string = yield;
    echo     $string.PHP_EOL;
    }
    }

    $printer = printer();
    $printer->send('Hello world!');
    $printer->send('Bye world!');
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    I'm printer! Hello world! Bye world!
    To Top