CKTIS / PHP
Parameter odovzdávaný odkazom (&$users)
Znak `&` pred parametrom `$users` umožňuje funkcii zmeniť premennú volajúceho bez toho, aby musela vrátiť pole. Pri volaní sa premenná zapisuje bez `&`.
Verzia: PHP 8.3; extension availability may vary
Syntax
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');V deklarácii array &$users určuje array typ argumentu a & označuje odovzdávanie odkazom. Lokálny parameter a premenná volajúceho sú dva názvy pre tú istú hodnotu. Znak & tu neoznačuje ukazovateľ ani bitový operátor AND a funkcia nevracia odkaz.
Volajte addUser($users, 'Lin') bez & a odovzdajte inicializovanú premennú. Platný je aj odkaz vrátený funkciou, ale nie literál poľa: addUser(['Ada'], 'Lin') vyvolá Error. PHP kontroluje typ array pri vstupe do funkcie, nie pri návrate. Odovzdanie premennej obsahujúcej reťazec vyvolá TypeError.
Príkaz $users[] = $name pridá prvok na koniec, zatiaľ čo bežné priradenie ako $users = [] by nahradilo celú hodnotu premennej volajúceho. Zmena zostáva viditeľná po volaní, hoci funkcia nevracia žiadnu hodnotu (void). Bez & sa pole predvolene odovzdáva hodnotou a pridanie prvku v tomto príklade zmení iba lokálne pole.
Použite &, keď chcete zámerne zmeniť premennú volajúceho. Tento účinok zdokumentujte, pretože zo samotného volania nie je zrejmý. Ak má volajúci rozhodnúť, či svoje pole nahradí, prevezmite pole hodnotou a vráťte upravené pole.
Príklady
<?php
function addUser(array &$users, string $name): void
{
$users[] = $name;
}
$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";
Výsledok
Ada Ada, Lin
Príklad používa PHP 8.3 v príkazovom riadku a nepotrebuje voliteľné rozšírenia. Očakávaný výstup je `Ada` pred volaním a `Ada, Lin` po ňom. Ak z deklarácie odstránite iba `&`, očakávajte `Ada` na oboch riadkoch.
Súvisiace lekcie
- PHP · Lekcia 28 · Stredne pokročilá · Verzia: 3