CKTIS / PHP
Referenčni parameter `&$value` in podajanje po vrednosti
V PHP 8.3 parameter `&$value` funkciji omogoča, da spremeni spremenljivko klicatelja. Pri privzetem podajanju po vrednosti prireditev parametru te spremenljivke ne spremeni.
Različica: PHP 8.3; extension availability may vary
Sintaksa
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);V deklaraciji int &$value znak & označuje podajanje po referenci. Lokalni parameter $value in spremenljivka klicatelja sta dve imeni za isto vrednost; referenca v PHP ni kazalec kot v jeziku C. Prireditev parametru $value spremeni vrednost pri klicatelju, vrnitev iz funkcije pa te spremembe ne razveljavi.
Znak & zapiši v deklaracijo, ne v klic: addOneByReference($number). Podaj spremenljivko ali rezultat funkcije, ki izrecno vrača po referenci. Literal 5 povzroči napako; navadni izrazi, kot je $number + 1, tu niso veljavni argumenti. Znak & pred imenom funkcije označuje vračanje po referenci, ne referenčnega parametra.
Brez & se argument poda po vrednosti: prireditev parametru $value ostane lokalna. Če je argument objekt, lahko obe spremenljivki še vedno označujeta isti objekt. Sprememba njegovih lastnosti je zato lahko vidna klicatelju, dodelitev drugega objekta parametru pa ne spremeni klicateljeve spremenljivke.
Pri int &$value se tip parametra preveri ob vstopu v funkcijo, ne ob izhodu. Sama deklaracija zato ne zagotavlja, da bo običajna spremenljivka klicatelja po klicu še vedno tipa int. Uporabi &, kadar je spreminjanje te spremenljivke del dogovorjenega vedenja funkcije, in dokumentiraj ta stranski učinek. Sicer razmisli o vračanju nove vrednosti.
Primeri
<?php
declare(strict_types=1);
function addOneByValue(int $value): void
{
$value += 1;
}
function addOneByReference(int &$value): void
{
$value += 1;
}
$number = 5;
addOneByValue($number);
echo "by value: $number\n";
addOneByReference($number);
echo "by reference: $number\n";
Rezultat
by value: 5 by reference: 6
Obe funkciji izvedeta `$value += 1`. Po klicu s podajanjem po vrednosti je `$number` še vedno `5`; po klicu s podajanjem po referenci je `6`.
Povezane lekcije
- PHP · Lekcija 77 · Napredna · Različica: 2