Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori