Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje