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

CKTIS / PHP

Referenčný parameter `&$value` a odovzdávanie hodnotou

V PHP 8.3 umožňuje parameter `&$value` funkcii zmeniť premennú volajúceho. Pri predvolenom odovzdávaní hodnotou priradenie do parametra túto premennú nezmení.

Verzia: PHP 8.3; extension availability may vary

Syntax

function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);

V deklarácii int &$value označuje & odovzdanie odkazom. Lokálny parameter $value a premenná volajúceho sú dva názvy tej istej hodnoty; referencia v PHP nie je ukazovateľ ako v C. Priradenie do $value zmení hodnotu u volajúceho a návrat z funkcie túto zmenu nezruší.

Znak & patrí do deklarácie, nie do volania: addOneByReference($number). Odovzdaj premennú alebo výsledok funkcie, ktorá výslovne vracia odkaz. Literál 5 spôsobí chybu; bežné výrazy ako $number + 1 tu nie sú platnými argumentmi. Znak & pred názvom funkcie označuje vrátenie odkazom, nie referenčný parameter.

Bez & sa argument odovzdáva hodnotou: priradenie do $value má iba lokálny účinok. Ak je argumentom objekt, obe premenné môžu naďalej označovať ten istý objekt. Zmena jeho vlastností preto môže byť viditeľná u volajúceho, ale priradenie iného objektu do parametra nezmení premennú volajúceho.

Pri int &$value sa typ parametra kontroluje pri vstupe do funkcie, nie pri návrate. Samotná deklarácia teda nezaručuje, že bežná premenná volajúceho bude aj po volaní typu int. Použi &, ak je zmena tejto premennej súčasťou dohodnutého správania funkcie, a zdokumentuj tento vedľajší účinok. Inak zváž vrátenie novej hodnoty.

Príklady

<?php
declare(strict_types=1);

function addOneByValue(int $value): void
{
    $value += 1;
}

function addOneByReference(int &$value): void
{
    $value += 1;
}

$number = 5;
addOneByValue($number);
echo "by value: $number\n";

addOneByReference($number);
echo "by reference: $number\n";

Výsledok

by value: 5
by reference: 6

Obe funkcie vykonajú `$value += 1`. Po volaní s odovzdaním hodnotou má `$number` stále hodnotu `5`; po volaní s odovzdaním odkazom má hodnotu `6`.

Súvisiace lekcie

  • PHP · Lekcia 77 · Pokročilá · Verzia: 2

Zdroje