CKTIS / PHP
Parameter odovzdávaný odkazom (`&$st`)
Znak `&` pred názvom parametra umožňuje funkcii zmeniť premennú volajúceho. V deklarácii napíš `&$st`, pri volaní však odovzdaj premennú bez `&`: `markReady($status)`.
Verzia: PHP 8.3; extension availability may vary
Syntax
function markReady(string &$st): void { $st .= '!'; }
markReady($status);V PHP 8.3 zápis string &$st znamená, že argument sa odovzdáva odkazom. Vo funkcii je $st lokálnym aliasom pre $status, premennú volajúceho: oba názvy odkazujú na tú istú hodnotu. Zápis cez $st teda zmení $status a zmena zostane viditeľná aj po skončení funkcie. Bez & sa argument predvolene odovzdáva hodnotou, takže priradenie do parametra nezmení premennú volajúceho.
Znak & napíš pred názov parametra v deklarácii, nie pri volaní. Odovzdaj inicializovanú premennú ako v markReady($status). Literál vo volaní markReady('Ready') nie je premenná a spôsobí chybu. Neodovzdávaj ani bežné výrazy, ktoré vypočítajú hodnotu; výsledok funkcie vracajúcej odkaz je samostatný povolený prípad.
Typ parametra string sa kontroluje pri vstupe do funkcie, ale pri návrate sa už znova nekontroluje. : void znamená, že funkcia nevracia hodnotu; účinok vidno v odovzdanej premennej. Použi &, keď chceš premennú volajúceho zámerne zmeniť, a toto správanie zdokumentuj, pretože zo samotného volania ho nevidno.
Príklady
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Výsledok
Ready Ready!
Na prvom riadku je `Ready`. Funkcia cez `$st` pripojí `!`, takže na druhom riadku je `Ready!`. Ak z deklarácie odstrániš iba `&`, na oboch riadkoch bude `Ready`.
Súvisiace lekcie
- PHP · Lekcia 34 · Stredne pokročilá · Verzia: 3