CKTIS / PHP
Parametr typu pole předávaný odkazem: `array &$items`
`array &$items` na začátku volání vyžaduje pole a umožňuje funkci změnit proměnnou volajícího, aniž by vracela výsledek.
Verze: PHP 8.3; extension availability may vary
Syntaxe
function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);V deklaraci function markReady(array &$items): void určuje array vstupní typ, $items je místní název parametru a & označuje předání odkazem. Parametr je aliasem proměnné volajícího: zápis do $items[0] i přiřazení nové hodnoty do $items se projeví u volajícího, a to i při : void.
Inicializuj proměnnou polem a zavolej markReady($cart). Znak & patří do deklarace, ne do volání. Nepředávej přímo literál pole jako ['draft'] ani běžný výsledek funkce vrácený hodnotou; výsledek vrácený odkazem předat lze. Pokud předaná proměnná neobsahuje pole, PHP při vstupu vyvolá TypeError. Při návratu se typ znovu nekontroluje, takže přiřazení přes $items může změnit i typ běžné proměnné volajícího.
Bez & se array $items předává hodnotou: nahrazení obyčejného řetězcového prvku jako v ukázce pole volajícího nezmění. Nejde o hlubokou kopii: odkazy, které už pole obsahuje, mohou dál sdílet hodnoty. Pokud změna argumentu není součástí kontraktu funkce, předej pole hodnotou a výsledek explicitně vrať.
unset($items) zruší místní vazbu, nikoli proměnnou volajícího. Naproti tomu foreach ($items as &$item) vytváří samostatný odkaz na prvek. Po takovém cyklu použij unset($item), aby pozdější zápis do $item nepřepsal poslední navštívený prvek.
Příklady
<?php
function markReadyCopy(array $items): void
{
$items[0] = 'ready';
}
function markReady(array &$items): void
{
$items[0] = 'ready';
}
$cart = ['draft'];
markReadyCopy($cart);
echo $cart[0], "\n";
markReady($cart);
echo $cart[0], "\n";
Výsledek
draft ready
Obě funkce zapisují `ready` na index `0`. Po volání s předáním hodnotou zůstává v `$cart[0]` hodnota `draft`; po volání s předáním odkazem tam je `ready`.
Související lekce
- PHP · Lekce 19 · Pokročilá · Verze: 2