CKTIS / PHP
Parameter odovzdávaný odkazom (`&$projects`)
Zápis `&$projects` umožňuje funkcii zmeniť premennú volajúceho. Znak `&` patrí do deklarácie parametra, nie do volania funkcie.
Verzia: PHP 8.3; extension availability may vary
Syntax
function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');V PHP 8.3 zápis array &$projects deklaruje parameter odovzdávaný odkazom. Počas volania sú $projects vo funkcii a $activeProjects vo volajúcom kóde dva názvy pre ten istý obsah. Pridanie prvku pomocou $projects[] = $name aj priradenie celého nového poľa do $projects zmení premennú volajúceho. Zmena zostane viditeľná aj po skončení funkcie; void znamená, že funkcia nevracia výsledok.
Znak & píš iba do deklarácie parametra. Funkciu volaj ako addProject($activeProjects, 'Beacon'), bez &. Odovzdaj inicializovanú premennú namiesto literálu poľa, ako je [], ktorý na tomto mieste spôsobí chybu. Odovzdať možno aj odkaz vrátený funkciou; bežná návratová hodnota premennú nenahradí.
PHP kontroluje typ array pri vstupe do funkcie, nie pri jej ukončení. Ak inicializovaná premenná neobsahuje pole, volanie vyvolá TypeError. Deklarácia parametra však nezaručuje, že po skončení funkcie zostane v premennej pole.
Bez & sa argument predvolene odovzdáva hodnotou: pridanie prvku by v tomto príklade zmenilo iba lokálne pole. Odkaz použi, ak chceš zámerne zmeniť premennú volajúceho, a tento účinok zdokumentuj. Ak má premenná zostať nezmenená, odovzdaj pole hodnotou a vráť jeho upravenú verziu.
Príklady
<?php
function addProject(array &$projects, string $name): void
{
$projects[] = $name;
}
$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";
Výsledok
Atlas Atlas, Beacon
Prvý riadok ukazuje stav pred volaním. Druhý ukazuje, že sa do `$activeProjects` pridal prvok `Beacon`, hoci `addProject()` nevracia žiadny výsledok.
Súvisiace lekcie
- PHP · Lekcia 12 · Stredne pokročilá · Verzia: 3
- PHP · Lekcia 13 · Stredne pokročilá · Verzia: 3