CKTIS / PHP
Referentni parametar `&$value` i prosljeđivanje po vrijednosti
U PHP-u 8.3 parametar `&$value` omogućuje funkciji da promijeni varijablu pozivatelja. Pri zadanom prosljeđivanju po vrijednosti dodjela parametru ne mijenja tu varijablu.
Verzija: PHP 8.3; extension availability may vary
Sintaksa
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);U deklaraciji int &$value znak & označava prosljeđivanje po referenci. Lokalni parametar $value i varijabla pozivatelja dva su imena za istu vrijednost; referenca u PHP-u nije pokazivač kao u C-u. Dodjela parametru $value mijenja vrijednost kod pozivatelja, a povratak iz funkcije ne poništava tu promjenu.
Znak & piše se u deklaraciji, ne u pozivu: addOneByReference($number). Proslijedi varijablu ili rezultat funkcije koja izričito vraća po referenci. Literal 5 uzrokuje pogrešku; obični izrazi poput $number + 1 ovdje nisu valjani argumenti. Znak & ispred imena funkcije označava povrat po referenci, a ne referentni parametar.
Bez & argument se prosljeđuje po vrijednosti: dodjela parametru $value ima samo lokalni učinak. Ako je argument objekt, obje varijable i dalje mogu označavati isti objekt. Promjena njegovih svojstava zato može biti vidljiva pozivatelju, ali dodjela drugog objekta parametru ne mijenja varijablu pozivatelja.
U int &$value tip parametra provjerava se pri ulasku u funkciju, a ne pri izlasku. Sama deklaracija zato ne jamči da će obična varijabla pozivatelja i nakon poziva biti tipa int. Upotrijebi & kada je promjena te varijable dio ugovora funkcije i dokumentiraj tu nuspojavu. Inače razmotri vraćanje nove vrijednosti.
Primjeri
<?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
Obje funkcije izvršavaju `$value += 1`. Nakon poziva s prosljeđivanjem po vrijednosti `$number` je i dalje `5`; nakon poziva s prosljeđivanjem po referenci iznosi `6`.
Povezane lekcije
- PHP · Lekcija 77 · Napredno · Verzija: 2