Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła