CKTIS / PHP
Parametr typu pole předávaný odkazem: `array &$product`
`array &$product` při volání vyžaduje pole a umožňuje funkci změnit proměnnou ve volajícím kódu, aniž by pole vracela.
Verze: PHP 8.3; extension availability may vary
Syntaxe
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 deklaraci function restock(array &$product): void určuje array vstupní typ, & označuje předání odkazem a $product je místní název parametru. Odkaz se týká proměnné obsahující celé pole; z prvků pole nedělá odkazy.
Před voláním restock($item) přiřaď do $item pole s číselnou hodnotou pod klíčem stock, například ['stock' => 3]. Znak & patří do deklarace, ne do volání. Literál pole není pro tento parametr platným argumentem. Platný argument ale může poskytnout funkce, která vrací pole odkazem.
$product a $item odkazují na tutéž hodnotu. Funkce může změnit prvek nebo nahradit celé pole a změna zůstane viditelná i po volání. : void znamená, že funkce nemá návratovou hodnotu, nikoli že nemá vedlejší účinky. Bez & jde o předání hodnotou a stejná změna běžného prvku zůstane místní; prvky, které už jsou odkazy, však mohou zůstat sdílené.
PHP ověřuje typ array při vstupu do funkce a vyvolá TypeError, pokud předaná proměnná neobsahuje pole. Nekontroluje klíče ani typy prvků a při návratu z funkce typ parametru znovu neověřuje. Prázdné pole tedy kontrolou typu projde, ale PHP 8.3 vydá varování, když se operátor += pokusí přečíst hodnotu pod chybějícím klíčem stock. Pokud měníš běžnou proměnnou, ponech v ní pole, jestliže s tím volající kód počítá.
Příklady
<?php
function restock(array &$product): void
{
$product['stock'] += 2;
}
$item = ['stock' => 3];
echo $item['stock'], "\n";
restock($item);
echo $item['stock'], "\n";
Výsledek
3 5
Na výstupu je nejprve `3`, potom `5`. Funkce přičte `2` k `$product['stock']`, takže `$item['stock']` má po volání hodnotu `5`, ačkoli funkce žádnou hodnotu nevrací.
Související lekce
- PHP · Lekce 20 · Pokročilá · Verze: 2