CKTIS / PHP
Parametr předávaný odkazem (&$users)
Znak `&` před parametrem `$users` umožňuje funkci změnit proměnnou volajícího, aniž by musela vracet pole. Při volání se proměnná zapisuje bez `&`.
Verze: PHP 8.3; extension availability may vary
Syntaxe
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');V deklaraci array &$users určuje array typ argumentu a & označuje předávání odkazem. Lokální parametr a proměnná volajícího jsou dvě jména pro stejnou hodnotu. Znak & zde neoznačuje ukazatel ani bitový operátor AND a funkce nevrací odkaz.
Volejte addUser($users, 'Lin') bez & a předejte inicializovanou proměnnou. Lze předat také odkaz vrácený funkcí, nikoli však literál pole: addUser(['Ada'], 'Lin') vyvolá Error. PHP kontroluje typ array při vstupu do funkce, nikoli při návratu. Předání proměnné obsahující řetězec vyvolá TypeError.
Příkaz $users[] = $name přidá prvek na konec, zatímco běžné přiřazení jako $users = [] by nahradilo celou hodnotu proměnné volajícího. Změna je viditelná i po volání, přestože funkce nevrací žádnou hodnotu (void). Bez & se pole ve výchozím nastavení předává hodnotou a přidání prvku v tomto příkladu změní jen lokální pole.
Používejte &, pokud chcete záměrně změnit proměnnou volajícího. Tento účinek zdokumentujte, protože ze samotného volání není patrný. Má-li volající rozhodnout, zda své pole nahradí, převezměte pole hodnotou a vraťte upravené pole.
Příklady
<?php
function addUser(array &$users, string $name): void
{
$users[] = $name;
}
$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";
Výsledek
Ada Ada, Lin
Příklad používá PHP 8.3 na příkazové řádce a nepotřebuje volitelná rozšíření. Očekávaný výstup je `Ada` před voláním a `Ada, Lin` po něm. Pokud z deklarace odstraníte pouze `&`, očekávejte `Ada` na obou řádcích.
Související lekce
- PHP · Lekce 28 · Středně pokročilá · Verze: 3