CKTIS / PHP
Eine Variable per Referenz in einer Closure erfassen: `use (&$MAP)`
Mit `use (&$MAP)` kann eine anonyme Funktion den aktuellen Zustand von `$MAP` aus ihrem Definitionsbereich lesen und ändern.
Version: PHP 8.3; extension availability may vary
Syntax
$increment = function (string $key) use (&$MAP): int {
return ++$MAP[$key];
};In PHP 8.3 steht use (&$MAP) nach der Parameterliste einer anonymen Funktion und vor ihrem optionalen Rückgabetyp. $MAP ist ein gewöhnlicher Variablenname. Im Beispiel enthält die Variable ein assoziatives Array, das Schlüsseln Werte zuordnet. & kennzeichnet hier eine Referenz und keine bitweise Operation.
Die Bindung entsteht beim Erzeugen der Closure im Definitionsbereich, nicht im Bereich des Aufrufs. Solange beide Bindungen bestehen, ist das Ersetzen des Arrays außen auch innen sichtbar; Änderungen an einem Eintrag innen sind auch außen sichtbar. Dagegen übernimmt use ($MAP) das Array mit Ganzzahlen im Beispiel mit seinem Wert zum Erzeugungszeitpunkt. Eine Pfeilfunktion (fn) erfasst die verwendeten äußeren Variablen automatisch per Wert.
Diese use-Klausel ist kein Namensraumimport. Sie ist auch kein Referenzparameter wie in function (array &$map), der eine beim Aufruf übergebene Variable bindet. Im Beispiel ist der Schlüssel das einzige Argument.
Die Closure kann auf den erfassten Zustand zugreifen, nachdem der Definitionsbereich verlassen wurde. unset($MAP) im äußeren Bereich löst nur die äußere Bindung. Eine danach neu angelegte Variable $MAP ist nicht mit der bestehenden Closure verbunden. Initialisiere die Map vor der Erfassung. Verwende & nur, wenn die Funktion ihren Zustand bewusst mit dem umgebenden Code teilen soll.
Beispiele
<?php
$MAP = ['apples' => 1];
$readSnapshot = function () use ($MAP): int {
return $MAP['apples'];
};
$increment = function (string $key) use (&$MAP): int {
return ++$MAP[$key];
};
$MAP = ['apples' => 2];
echo $readSnapshot(), "\n";
echo $increment('apples'), "\n";
echo $MAP['apples'], "\n";
Ergebnis
1 3 3
Der erste Lesezugriff ergibt `1` aus dem per Wert erfassten Array. Nach dem Ersetzen der Map sieht die Closure mit Referenz den Wert `2` und erhöht den vorhandenen Eintrag `apples` auf `3`. Der äußere Lesezugriff ergibt ebenfalls `3`. Das Beispiel benötigt keine zusätzliche Erweiterung.
Zugehörige Lektionen
- PHP · Lektion 36 · Mittlere Stufe · Version: 3