CKTIS / PHP
Parametry předávané odkazem (&$tasks, &$used)
Znak `&` u parametrů `$tasks` a `$used` umožňuje funkci změnit obě proměnné volajícího, aniž by je musela vracet.
Verze: PHP 8.3; extension availability may vary
Syntaxe
function addTask(array &$tasks, array &$used, string $name): void { /* ... */ }
addTask($tasks, $used, 'Review');V PHP 8.3 se & v deklaraci píše přímo před název parametru: array &$tasks, array &$used. Při volání addTask($tasks, $used, 'Review') znak & nepoužívej. U $name znak & není, proto se příslušný argument předává hodnotou, což je výchozí způsob.
Během volání je každý parametr předávaný odkazem místním aliasem předané proměnné. Úprava prvku pole nebo přiřazení nové hodnoty parametru změní proměnnou volajícího. Změny zůstanou viditelné i po návratu z funkce, a to i při návratovém typu void. Znak & u parametru neznamená, že funkce vrací odkazem.
Nejjednodušší je předávat inicializované proměnné. Předat lze také výsledek funkce, která vrací odkazem. Místo $tasks nebo $used nepředávej literál jako [] ani výsledek běžného výrazu. Literál na této pozici způsobí chybu.
Deklarace array se kontroluje při vstupu do funkce: pokud předaná proměnná neobsahuje pole, nastane TypeError. Při návratu už PHP typy těchto parametrů znovu nekontroluje. V dokumentaci uveď, které argumenty funkce mění, protože z volání to není patrné. Tato vlastnost nevyžaduje žádné další rozšíření.
Příklady
<?php
function addTask(array &$tasks, array &$used, string $name): void
{
$tasks[] = $name;
$used[$name] = true;
}
$tasks = [];
$used = [];
addTask($tasks, $used, 'Review');
echo $tasks[0], "\n";
echo $used['Review'] ? "used\n" : "unused\n";
Výsledek
Review used
Po volání obsahuje `$tasks[0]` hodnotu `Review` a `$used['Review']` má hodnotu `true`. Skript proto vypíše `Review` a na dalším řádku `used`.
Související lekce
- PHP · Lekce 12 · Základní · Verze: 2