CKTIS / PHP
Parametr przekazywany przez referencję (`&$st`)
Znak `&` przed nazwą parametru pozwala funkcji zmienić zmienną wywołującego. W deklaracji piszesz `&$st`, a przy wywołaniu przekazujesz samą zmienną: `markReady($status)`.
Wersja: PHP 8.3; extension availability may vary
Składnia
function markReady(string &$st): void { $st .= '!'; }
markReady($status);W PHP 8.3 zapis string &$st oznacza, że argument jest przekazywany przez referencję. Wewnątrz funkcji $st jest lokalnym aliasem zmiennej $status przekazanej przez wywołującego: obie nazwy odnoszą się do tej samej wartości. Zapis przez $st zmienia więc $status, a zmiana pozostaje widoczna po zakończeniu funkcji. Bez & parametr jest domyślnie przekazywany przez wartość i przypisanie do niego nie zmienia zmiennej wywołującego.
Znak & umieść przed nazwą parametru w deklaracji, nie przy wywołaniu. Przekaż zainicjalizowaną zmienną, tak jak w markReady($status). Literał w markReady('Ready') nie jest zmienną i powoduje błąd. Nie przekazuj też zwykłych wyrażeń obliczających wartość; osobnym dozwolonym przypadkiem jest wynik funkcji zwracającej przez referencję.
Deklaracja string określa typ parametru sprawdzany przy wejściu do funkcji, ale nie ponownie przy jej zakończeniu. : void oznacza, że funkcja nie zwraca wartości; efekt widać w przekazanej zmiennej. Stosuj &, gdy zmiana zmiennej wywołującego jest zamierzona, i jasno ją udokumentuj, bo samo wywołanie jej nie sygnalizuje.
Przykłady
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Wynik
Ready Ready!
Pierwszy wiersz to `Ready`. Funkcja dopisuje `!` przez `$st`, więc drugi wiersz to `Ready!`. Po usunięciu samego `&` z deklaracji oba wiersze to `Ready`.
Powiązane lekcje
- PHP · Lekcja 34 · Średniozaawansowany · Wersja: 3