Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje