CKTIS / PHP
Parameter tipa polje, podan po referenci: `array &$product`
`array &$product` ob klicu zahteva polje in funkciji omogoča, da spremeni spremenljivko v klicni kodi, ne da bi polje vrnila.
Različica: 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);V deklaraciji function restock(array &$product): void zapis array določa vhodni tip, & označuje podajanje po referenci, $product pa je lokalno ime parametra. Referenca velja za spremenljivko, ki vsebuje celotno polje; elementov polja ne spremeni v reference.
Pred klicem restock($item) spremenljivki $item priredi polje, ki ima pri ključu stock številsko vrednost, na primer ['stock' => 3]. Znak & sodi v deklaracijo, ne v klic. Literal polja ni veljaven argument za ta parameter, lahko pa ga zagotovi funkcija, ki vrne polje po referenci.
$product in $item se nanašata na isto vrednost. Funkcija lahko spremeni element ali zamenja celotno polje, sprememba pa ostane vidna po klicu. : void pomeni, da funkcija ne vrne vrednosti, ne pa, da nima stranskih učinkov. Brez & se argument poda po vrednosti in enaka sprememba običajnega elementa ostane lokalna; elementi, ki so že reference, pa lahko ostanejo v skupni rabi.
PHP ob vstopu v funkcijo preveri tip array in sproži TypeError, če podana spremenljivka ne vsebuje polja. Ne preverja ključev ali tipov elementov in ob izstopu iz funkcije ne preveri znova tipa parametra. Prazno polje torej prestane preverjanje tipa, vendar PHP 8.3 izda opozorilo, ko operater += poskuša prebrati vrednost pri manjkajočem ključu stock. Če spreminjaš običajno spremenljivko, poskrbi, da še naprej vsebuje polje, če ga klicna koda pričakuje.
Primeri
<?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
Izpis je najprej `3`, nato `5`. Funkcija prišteje `2` k `$product['stock']`, zato je `$item['stock']` po klicu `5`, čeprav funkcija ne vrne nobene vrednosti.
Povezane lekcije
- PHP · Lekcija 20 · Napredna · Različica: 2