CKTIS / PHP
Parameterübergabe per Referenz (&$tasks, &$used)
Mit `&` bei den Parametern `$tasks` und `$used` kann die Funktion beide Variablen des Aufrufers ändern, ohne sie zurückzugeben.
Version: PHP 8.3; extension availability may vary
Syntax
function addTask(array &$tasks, array &$used, string $name): void { /* ... */ }
addTask($tasks, $used, 'Review');In PHP 8.3 steht & in der Deklaration direkt vor dem Parameternamen: array &$tasks, array &$used. Beim Aufruf addTask($tasks, $used, 'Review') lässt du & weg. Bei $name steht kein &; sein Argument wird daher wie üblich als Wert übergeben.
Während des Aufrufs ist jeder Referenzparameter ein lokaler Alias für die übergebene Variable im aufrufenden Code. Wenn die Funktion ein Array-Element ändert oder dem Parameter einen neuen Wert zuweist, ändert sich die Variable des Aufrufers. Die Änderungen bleiben nach dem Aufruf sichtbar, auch beim Rückgabetyp void. Ein & am Parameter bedeutet keine Rückgabe per Referenz.
Am einfachsten ist es, initialisierte Variablen zu übergeben. Auch der Aufruf einer Funktion, die per Referenz zurückgibt, kann als Argument dienen. Übergib anstelle von $tasks oder $used weder ein Literal wie [] noch das Ergebnis eines gewöhnlichen Ausdrucks. Ein Literal an dieser Stelle verursacht einen Fehler.
PHP prüft array beim Eintritt in die Funktion: Enthält eine übergebene Variable kein Array, wird ein TypeError ausgelöst. Bei der Rückkehr prüft PHP diese Parametertypen nicht erneut. Dokumentiere, welche Argumente die Funktion verändert, da man es am Aufruf nicht erkennt. Diese Funktionalität benötigt keine zusätzliche Erweiterung.
Beispiele
<?php
function addTask(array &$tasks, array &$used, string $name): void
{
$tasks[] = $name;
$used[$name] = true;
}
$tasks = [];
$used = [];
addTask($tasks, $used, 'Review');
echo $tasks[0], "\n";
echo $used['Review'] ? "used\n" : "unused\n";
Ergebnis
Review used
Nach dem Aufruf enthält `$tasks[0]` den Wert `Review`, und `$used['Review']` ist `true`. Deshalb gibt das Skript `Review` und in der nächsten Zeile `used` aus.
Zugehörige Lektionen
- PHP · Lektion 12 · Grundlagen · Version: 2