CKTIS / PHP
Parametar koji se prosljeđuje po referenci (&$users)
Znak `&` ispred parametra `$users` omogućuje funkciji da promijeni varijablu pozivatelja bez vraćanja polja. Pri pozivu se varijabla prosljeđuje bez znaka `&`.
Verzija: PHP 8.3; extension availability may vary
Sintaksa
function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');U deklaraciji array &$users oznaka array određuje tip argumenta, a & označava prosljeđivanje po referenci. Lokalni parametar i varijabla pozivatelja dva su imena za istu vrijednost. Znak & ovdje ne označava pokazivač ni operator bitovnog I, a funkcija ne vraća referencu.
Pozovite addUser($users, 'Lin') bez znaka & i proslijedite inicijaliziranu varijablu. Možete proslijediti i referencu koju vrati funkcija, ali ne i literal polja: addUser(['Ada'], 'Lin') izaziva Error. PHP provjerava tip array pri ulasku u funkciju, ne pri povratku. Prosljeđivanje varijable koja sadrži znakovni niz izaziva TypeError.
$users[] = $name dodaje element na kraj, dok bi obična dodjela poput $users = [] zamijenila cijelu vrijednost varijable pozivatelja. Promjena ostaje vidljiva nakon poziva, iako funkcija ne vraća vrijednost (void). Bez znaka & polje se prema zadanim postavkama prosljeđuje po vrijednosti pa dodavanje u ovom primjeru mijenja samo lokalno polje.
Upotrijebite & kada namjerno želite promijeniti varijablu pozivatelja i dokumentirajte taj učinak jer nije vidljiv iz samog poziva. Ako pozivatelj treba odlučiti hoće li zamijeniti svoje polje, primite ga po vrijednosti i vratite izmijenjeno polje.
Primjeri
<?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
Primjer koristi PHP 8.3 u naredbenom retku i ne treba neobavezna proširenja. Očekuje se `Ada` prije poziva i `Ada, Lin` nakon njega. Uklonite li samo `&` iz deklaracije, očekujte `Ada` u oba retka.
Povezane lekcije
- PHP · Lekcija 28 · Srednje · Verzija: 3