Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri