CKTIS / PHP
Parametry przekazywane przez referencję (&$tasks, &$used)
Znak `&` przy parametrach `$tasks` i `$used` pozwala funkcji zmienić obie zmienne wywołującego bez zwracania ich.
Wersja: PHP 8.3; extension availability may vary
Składnia
function addTask(array &$tasks, array &$used, string $name): void { /* ... */ }
addTask($tasks, $used, 'Review');W PHP 8.3 znak & umieszcza się bezpośrednio przed nazwą parametru w deklaracji: array &$tasks, array &$used. Przy wywołaniu addTask($tasks, $used, 'Review') nie wpisuj &. Parametr $name nie ma &, więc argument jest przekazywany do niego przez wartość, czyli domyślnie.
Podczas wywołania każdy parametr referencyjny jest lokalnym aliasem zmiennej przekazanej przez wywołującego. Zmiana elementu tablicy lub przypisanie parametrowi nowej wartości zmienia zmienną wywołującego. Zmiany pozostają widoczne po zakończeniu funkcji, nawet gdy ma ona typ zwracany void. & przy parametrze nie oznacza zwracania przez referencję.
Najprościej przekazać zainicjalizowane zmienne. Można też przekazać wynik funkcji, która zwraca przez referencję. Nie przekazuj literałów takich jak [] ani zwykłych wyników wyrażeń zamiast $tasks lub $used; literał w tym miejscu powoduje błąd.
Deklaracja array jest sprawdzana przy wejściu do funkcji: przekazanie zmiennej, która nie zawiera tablicy, powoduje TypeError. PHP nie sprawdza ponownie typu tych parametrów przy wyjściu. Dokumentuj, które argumenty funkcja zmienia, ponieważ w miejscu wywołania tego nie widać. Mechanizm nie wymaga dodatkowego rozszerzenia.
Przykłady
<?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";
Wynik
Review used
Po wywołaniu `$tasks[0]` zawiera `Review`, a `$used['Review']` ma wartość `true`. Dlatego program wypisuje `Review`, a w kolejnym wierszu `used`.
Powiązane lekcje
- PHP · Lekcja 12 · Podstawowy · Wersja: 2