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