Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / PHP

Referentni parametar `&$value` i prosljeđivanje po vrijednosti

U PHP-u 8.3 parametar `&$value` omogućuje funkciji da promijeni varijablu pozivatelja. Pri zadanom prosljeđivanju po vrijednosti dodjela parametru ne mijenja tu varijablu.

Verzija: PHP 8.3; extension availability may vary

Sintaksa

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

U deklaraciji int &$value znak & označava prosljeđivanje po referenci. Lokalni parametar $value i varijabla pozivatelja dva su imena za istu vrijednost; referenca u PHP-u nije pokazivač kao u C-u. Dodjela parametru $value mijenja vrijednost kod pozivatelja, a povratak iz funkcije ne poništava tu promjenu.

Znak & piše se u deklaraciji, ne u pozivu: addOneByReference($number). Proslijedi varijablu ili rezultat funkcije koja izričito vraća po referenci. Literal 5 uzrokuje pogrešku; obični izrazi poput $number + 1 ovdje nisu valjani argumenti. Znak & ispred imena funkcije označava povrat po referenci, a ne referentni parametar.

Bez & argument se prosljeđuje po vrijednosti: dodjela parametru $value ima samo lokalni učinak. Ako je argument objekt, obje varijable i dalje mogu označavati isti objekt. Promjena njegovih svojstava zato može biti vidljiva pozivatelju, ali dodjela drugog objekta parametru ne mijenja varijablu pozivatelja.

U int &$value tip parametra provjerava se pri ulasku u funkciju, a ne pri izlasku. Sama deklaracija zato ne jamči da će obična varijabla pozivatelja i nakon poziva biti tipa int. Upotrijebi & kada je promjena te varijable dio ugovora funkcije i dokumentiraj tu nuspojavu. Inače razmotri vraćanje nove vrijednosti.

Primjeri

<?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";

Rezultat

by value: 5
by reference: 6

Obje funkcije izvršavaju `$value += 1`. Nakon poziva s prosljeđivanjem po vrijednosti `$number` je i dalje `5`; nakon poziva s prosljeđivanjem po referenci iznosi `6`.

Povezane lekcije

  • PHP · Lekcija 77 · Napredno · Verzija: 2

Izvori