Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

Parametr przekazywany przez referencję `&$res`

Znak `&` przed nazwą parametru `$res` pozwala funkcji zmienić zmienną przekazaną przez wywołującego, zamiast zwracać jej nową wartość.

Wersja: PHP 8.3; extension availability may vary

Składnia

function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);

W sygnaturze funkcji &$res oznacza parametr przekazywany przez referencję. Podczas wywołania lokalna nazwa $res staje się aliasem zmiennej przekazanej przez wywołującego. Przypisanie do $res zmienia tę zmienną, w odróżnieniu od zwykłego przekazania przez wartość. res to zwykła nazwa, nie słowo kluczowe; & nie oznacza tu wskaźnika ani zwracania przez referencję.

Znak & umieszcza się w deklaracji, nie w wywołaniu: napisz writeSum(2, 3, $total). W miejscu argumentu przekazywanego przez referencję użyj zmiennej, a nie literału, takiego jak 0, ani wyrażenia obliczanego, takiego jak 2 + 3. Można też przekazać referencję zwróconą przez funkcję zadeklarowaną jako zwracająca przez referencję.

W PHP 8.3 typ w int &$res jest sprawdzany przy wejściu do funkcji, a nie ponownie przy jej zakończeniu. Sam zapis nie gwarantuje więc, że po wywołaniu zmienna nadal zawiera wartość typu int. unset($res) wewnątrz funkcji usuwa tylko lokalne powiązanie, nie zmienną wywołującego.

Udokumentuj, które argumenty funkcja może nadpisać. Jeśli potrzebujesz przekazać wywołującemu tylko jeden wynik i nie musisz zmieniać jego zmiennej, zwykłe return jest zazwyczaj czytelniejsze. Składnia należy do języka PHP i nie wymaga dodatkowego rozszerzenia.

Przykłady

<?php
declare(strict_types=1);

function writeSum(int $left, int $right, int &$res): void
{
    $res = $left + $right;
}

$total = 0;
echo "before: ", $total, "\n";
writeSum(2, 3, $total);
echo "after: ", $total, "\n";

Wynik

before: 0
after: 5

Początkowo `$total` ma wartość `0`. Przypisanie przez `$res` zmienia ją na `5`, choć `writeSum()` ma typ zwracany `void` i nie zwraca wyniku.

Powiązane lekcje

  • PHP · Lekcja 70 · Zaawansowany · Wersja: 2

Źródła