CKTIS / PHP
Parameter, podan po referenci (&$users)
Znak `&` pred parametrom `$users` funkciji omogoča, da spremeni spremenljivko klicatelja, ne da bi vrnila polje. Ob klicu spremenljivko podamo brez `&`.
Različica: PHP 8.3; extension availability may vary
Sintaksa
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');V zapisu array &$users določa array tip argumenta, & pa označuje podajanje po referenci. Lokalni parameter in spremenljivka klicatelja sta dve imeni za isto vrednost. Znak & tu ne označuje kazalca ali operatorja za bitni IN, funkcija pa ne vrača reference.
Pokličite addUser($users, 'Lin') brez znaka & in podajte inicializirano spremenljivko. Veljavna je tudi referenca, ki jo vrne funkcija, ne pa dobesedni zapis polja: addUser(['Ada'], 'Lin') sproži Error. PHP preveri tip array ob vstopu v funkcijo, ne ob vrnitvi. Če podate spremenljivko, ki vsebuje niz, se sproži TypeError.
$users[] = $name doda element na konec, medtem ko bi navadna prireditev, kot je $users = [], nadomestila celotno vrednost spremenljivke klicatelja. Sprememba je vidna tudi po klicu, čeprav funkcija ne vrne vrednosti (void). Brez & se polje privzeto poda po vrednosti, zato dodajanje v tem primeru spremeni le lokalno polje.
Uporabite &, kadar želite namenoma spremeniti spremenljivko klicatelja, in ta učinek dokumentirajte, saj iz samega klica ni razviden. Če naj se klicatelj sam odloči, ali bo zamenjal svoje polje, ga sprejmite po vrednosti in vrnite spremenjeno polje.
Primeri
<?php
function addUser(array &$users, string $name): void
{
$users[] = $name;
}
$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";
Rezultat
Ada Ada, Lin
Primer uporablja PHP 8.3 v ukazni vrstici in ne potrebuje izbirnih razširitev. Pričakovani izpis je `Ada` pred klicem in `Ada, Lin` po njem. Če iz deklaracije odstranite samo `&`, pričakujte `Ada` v obeh vrsticah.
Povezane lekcije
- PHP · Lekcija 28 · Srednja · Različica: 3