CKTIS / PHP
Parametar tipa polje koji se prosljeđuje referencom: `array &$product`
`array &$product` pri pozivu zahtijeva polje i omogućuje funkciji da promijeni varijablu u pozivajućem kodu bez vraćanja polja.
Verzija: PHP 8.3; extension availability may vary
Sintaksa
function restock(array &$product): void { $product['stock'] += 2; }
// Call with an array variable containing a numeric 'stock' value, without &:
$item = ['stock' => 3];
restock($item);U deklaraciji function restock(array &$product): void, array određuje ulazni tip, & označava prosljeđivanje referencom, a $product je lokalni naziv parametra. Referenca se odnosi na varijablu koja sadrži cijelo polje; pojedini elementi time ne postaju reference.
Prije poziva restock($item) dodijeli varijabli $item polje s brojčanom vrijednošću pod ključem stock, primjerice ['stock' => 3]. Znak & piše se u deklaraciji, ne u pozivu. Literal polja nije valjan argument za ovaj parametar, ali valjan argument može dati funkcija koja vraća polje referencom.
$product i $item odnose se na istu vrijednost. Funkcija može izmijeniti element ili zamijeniti cijelo polje, a promjena ostaje vidljiva nakon poziva. : void znači da nema povratne vrijednosti, a ne da nema sporednih učinaka. Bez & argument se prosljeđuje po vrijednosti pa ista izmjena običnog elementa ostaje lokalna; elementi koji su već reference ipak mogu ostati zajednički.
PHP pri ulasku u funkciju provjerava tip array i izaziva TypeError ako proslijeđena varijabla ne sadrži polje. Ne provjerava ključeve ni tipove elemenata i ne provjerava ponovno tip parametra pri izlasku. Prazno polje stoga prolazi provjeru tipa, ali PHP 8.3 izdaje upozorenje kad operator += pokuša pročitati vrijednost pod nepostojećim ključem stock. Ako mijenjaš običnu varijablu, pobrini se da i dalje sadrži polje ako pozivajući kod to očekuje.
Primjeri
<?php
function restock(array &$product): void
{
$product['stock'] += 2;
}
$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";
Rezultat
3 5
Ispis je najprije `3`, zatim `5`. Funkcija dodaje `2` vrijednosti `$product['stock']`, pa je `$item['stock']` nakon poziva `5` iako funkcija ne vraća vrijednost.
Povezane lekcije
- PHP · Lekcija 20 · Napredno · Verzija: 2