CKTIS / PHP
Parameter typu pole odovzdávaný odkazom: `array &$product`
`array &$product` pri volaní vyžaduje pole a umožňuje funkcii zmeniť premennú vo volajúcom kóde bez toho, aby pole vracala.
Verzia: PHP 8.3; extension availability may vary
Syntax
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 deklarácii function restock(array &$product): void určuje array vstupný typ, & označuje odovzdanie odkazom a $product je lokálny názov parametra. Odkaz sa vzťahuje na premennú, ktorá obsahuje celé pole; z prvkov poľa nerobí odkazy.
Pred volaním restock($item) priraď do $item pole s číselnou hodnotou pod kľúčom stock, napríklad ['stock' => 3]. Znak & patrí do deklarácie, nie do volania. Literál poľa nie je pre tento parameter platným argumentom. Platný argument však môže poskytnúť funkcia, ktorá vracia pole odkazom.
$product a $item odkazujú na tú istú hodnotu. Funkcia môže zmeniť prvok alebo nahradiť celé pole a zmena zostane viditeľná aj po volaní. : void znamená, že funkcia nemá návratovú hodnotu, nie že nemá vedľajšie účinky. Bez & sa parameter odovzdáva hodnotou a rovnaká zmena bežného prvku zostane lokálna; prvky, ktoré už sú odkazmi, však môžu zostať zdieľané.
PHP kontroluje typ array pri vstupe do funkcie a vyvolá TypeError, ak odovzdaná premenná neobsahuje pole. Nekontroluje kľúče ani typy prvkov a pri návrate z funkcie typ parametra znova neoveruje. Prázdne pole teda prejde kontrolou typu, ale PHP 8.3 vydá upozornenie, keď sa operátor += pokúsi prečítať hodnotu pod chýbajúcim kľúčom stock. Ak meníš bežnú premennú, ponechaj v nej pole, pokiaľ s tým volajúci kód počíta.
Príklady
<?php
function restock(array &$product): void
{
$product['stock'] += 2;
}
$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";
Výsledok
3 5
Na výstupe je najskôr `3`, potom `5`. Funkcia pripočíta `2` k `$product['stock']`, takže `$item['stock']` má po volaní hodnotu `5`, hoci funkcia žiadnu hodnotu nevracia.
Súvisiace lekcie
- PHP · Lekcia 20 · Pokročilá · Verzia: 2