CKTIS / PHP
Parameter typu pole odovzdávaný odkazom: `array &$items`
`array &$items` vyžaduje na začiatku volania pole a umožňuje funkcii zmeniť premennú volajúceho bez vrátenia výsledku.
Verzia: PHP 8.3; extension availability may vary
Syntax
function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);V deklarácii function markReady(array &$items): void určuje array vstupný typ, $items je lokálny názov parametra a & označuje odovzdanie odkazom. Parameter je aliasom premennej volajúceho: zápis do $items[0] aj priradenie novej hodnoty do $items sa prejavia u volajúceho, a to aj pri : void.
Inicializuj premennú poľom a zavolaj markReady($cart). Znak & patrí do deklarácie, nie do volania. Neodovzdávaj priamo literál poľa ako ['draft'] ani bežný výsledok funkcie vrátený hodnotou; výsledok vrátený odkazom odovzdať môžeš. Ak odovzdaná premenná neobsahuje pole, PHP pri vstupe vyvolá TypeError. Pri návrate sa typ znova nekontroluje, takže priradenie cez $items môže zmeniť aj typ bežnej premennej volajúceho.
Bez & sa array $items odovzdáva hodnotou: nahradenie obyčajného reťazcového prvku ako v príklade nezmení pole volajúceho. Nejde o hĺbkovú kópiu: odkazy, ktoré už pole obsahuje, môžu naďalej zdieľať hodnoty. Ak zmena argumentu nie je súčasťou kontraktu funkcie, prijmi pole hodnotou a výsledok explicitne vráť.
unset($items) zruší lokálnu väzbu, nie premennú volajúceho. Naproti tomu foreach ($items as &$item) vytvorí samostatný odkaz na prvok. Po takomto cykle použi unset($item), aby neskorší zápis do $item neprepísal posledný navštívený prvok.
Prí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ýsledok
draft ready
Obe funkcie zapíšu `ready` na index `0`. Po volaní s odovzdaním hodnotou je v `$cart[0]` stále `draft`; po volaní s odovzdaním odkazom je tam `ready`.
Súvisiace lekcie
- PHP · Lekcia 19 · Pokročilá · Verzia: 2