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

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

Zdroje