Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri