CKTIS / PHP
Parametr předávaný odkazem (`&$st`)
Znak `&` před názvem parametru umožňuje funkci změnit proměnnou volajícího. V deklaraci napiš `&$st`, při volání ale předej proměnnou bez `&`: `markReady($status)`.
Verze: PHP 8.3; extension availability may vary
Syntaxe
function markReady(string &$st): void { $st .= '!'; }
markReady($status);V PHP 8.3 zápis string &$st znamená, že se argument předává odkazem. Uvnitř funkce je $st místní alias proměnné $status z volajícího kódu: oba názvy odkazují na tutéž hodnotu. Zápis přes $st tedy změní $status a změna je viditelná i po skončení funkce. Bez & se ve výchozím nastavení předává hodnotou, takže přiřazení do parametru proměnnou volajícího nezmění.
Znak & napiš před název parametru v deklaraci, ne při volání. Předej inicializovanou proměnnou jako v markReady($status). Literál ve volání markReady('Ready') není proměnná a způsobí chybu. Nepředávej ani běžné výrazy, které vypočítají hodnotu; výsledek funkce vracející odkaz je samostatný povolený případ.
Typ parametru string se kontroluje při vstupu do funkce, nikoli znovu při návratu. : void znamená, že funkce nevrací žádnou hodnotu; účinek je vidět v předané proměnné. Použij &, pokud chceš proměnnou volajícího záměrně změnit, a toto chování zdokumentuj, protože ze samotného volání není patrné.
Příklady
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Výsledek
Ready Ready!
Na prvním řádku je `Ready`. Funkce přes `$st` připojí `!`, takže na druhém řádku je `Ready!`. Když z deklarace odstraníš jen `&`, na obou řádcích bude `Ready`.
Související lekce
- PHP · Lekce 34 · Středně pokročilá · Verze: 3