CKTIS / PHP
Parametr przekazywany przez referencję (&$users)
Znak `&` przy parametrze `$users` pozwala funkcji zmienić zmienną wywołującego bez zwracania tablicy. W wywołaniu podaje się samą zmienną, bez `&`.
Wersja: PHP 8.3; extension availability may vary
Składnia
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');W deklaracji array &$users słowo array określa typ argumentu, a & oznacza przekazywanie przez referencję. Parametr lokalny i zmienna wywołującego są dwiema nazwami tej samej wartości. Nie jest to wskaźnik ani bitowy operator AND, a funkcja nie zwraca referencji.
Wywołaj addUser($users, 'Lin'), bez &. Przekaż zainicjalizowaną zmienną. Można też przekazać referencję zwróconą przez funkcję, ale nie literał tablicowy: addUser(['Ada'], 'Lin') powoduje Error. Typ array jest sprawdzany przy wejściu do funkcji, nie przy wyjściu; przekazanie zmiennej zawierającej ciąg znaków powoduje TypeError.
Instrukcja $users[] = $name dopisuje element, a zwykłe przypisanie $users = [] zastąpiłoby całą wartość zmiennej wywołującego. Zmiana pozostaje widoczna po zakończeniu wywołania, mimo że funkcja niczego nie zwraca (void). Bez & tablica jest domyślnie przekazywana przez wartość i dopisanie elementu w przykładzie zmienia tylko tablicę lokalną.
Używaj &, gdy zmiana zmiennej wywołującego jest zamierzona, i dokumentuj ten efekt: w samym wywołaniu go nie widać. Jeśli wywołujący ma sam zdecydować, czy zastąpić swoją tablicę, przekaż ją przez wartość i zwróć zmienioną tablicę.
Przykłady
<?php
function addUser(array &$users, string $name): void
{
$users[] = $name;
}
$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";
Wynik
Ada Ada, Lin
Przykład działa w konsoli PHP 8.3 bez opcjonalnych rozszerzeń. Oczekiwany wynik to `Ada` przed wywołaniem i `Ada, Lin` po nim. Po usunięciu tylko `&` z deklaracji oczekuj `Ada` w obu wierszach.
Powiązane lekcje
- PHP · Lekcja 28 · Średniozaawansowany · Wersja: 3