CKTIS / PHP
Parametr tablicowy przekazywany przez referencję: `array &$items`
Deklaracja `array &$items` wymaga tablicy w chwili wywołania i pozwala funkcji zmienić zmienną przekazaną przez wywołującego bez zwracania wyniku.
Wersja: PHP 8.3; extension availability may vary
Składnia
function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);W sygnaturze function markReady(array &$items): void słowo array określa typ wejściowy, $items to lokalna nazwa parametru, a & oznacza przekazanie przez referencję. Parametr staje się aliasem zmiennej wywołującego: zarówno zapis do $items[0], jak i przypisanie nowej wartości do $items są widoczne po wywołaniu, nawet przy : void.
Zainicjuj zmienną tablicą i wywołaj markReady($cart). Znak & występuje w deklaracji parametru, nie w wywołaniu. Nie podawaj bezpośrednio literału ['draft'] ani zwykłego wyniku funkcji zwracającej przez wartość; wynik zwracany przez referencję może być argumentem. Jeśli przekazana zmienna nie zawiera tablicy, PHP zgłasza TypeError przy wejściu do funkcji. Typ nie jest ponownie sprawdzany przy wyjściu, więc funkcja może nawet zmienić typ zwykłej zmiennej, przypisując przez $items wartość niebędącą tablicą.
Bez & parametr array $items jest przekazywany przez wartość: zastąpienie zwykłego elementu będącego napisem, jak w przykładzie, nie zmienia tablicy wywołującego. Nie jest to kopia głęboka: istniejące referencje w elementach tablicy mogą nadal współdzielić te same wartości. Jeżeli modyfikowanie argumentu nie jest częścią kontraktu funkcji, przyjmij tablicę przez wartość i jawnie zwróć wynik.
unset($items) usuwa lokalne powiązanie, nie zmienną wywołującego. Z kolei foreach ($items as &$item) tworzy odrębną referencję do elementu. Po takiej pętli użyj unset($item), żeby późniejszy zapis do $item nie nadpisał ostatniego odwiedzonego elementu.
Przykłady
<?php
function markReadyCopy(array $items): void
{
$items[0] = 'ready';
}
function markReady(array &$items): void
{
$items[0] = 'ready';
}
$cart = ['draft'];
markReadyCopy($cart);
echo $cart[0], "\n";
markReady($cart);
echo $cart[0], "\n";
Wynik
draft ready
Obie funkcje zapisują `ready` pod indeksem `0`. Po wywołaniu przez wartość `$cart[0]` nadal zawiera `draft`; po wywołaniu przez referencję zawiera `ready`.
Powiązane lekcje
- PHP · Lekcja 19 · Zaawansowany · Wersja: 2