Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła