CKTIS / PHP
Parameter, podan po referenci (`&$st`)
Znak `&` pred imenom parametra omogoča funkciji, da spremeni spremenljivko iz klicne kode. V deklaraciji napiši `&$st`, pri klicu pa spremenljivko podaj brez `&`: `markReady($status)`.
Različica: PHP 8.3; extension availability may vary
Sintaksa
function markReady(string &$st): void { $st .= '!'; }
markReady($status);V PHP 8.3 zapis string &$st določa, da se argument poda po referenci. Znotraj funkcije je $st lokalni vzdevek za $status iz klicne kode: obe imeni se nanašata na isto vrednost. Zapis prek $st zato spremeni $status, sprememba pa je vidna tudi po koncu funkcije. Brez & se argument privzeto poda po vrednosti, zato prirejanje parametru ne spremeni spremenljivke iz klicne kode.
Znak & zapiši pred ime parametra v deklaraciji, ne v klicu. Podaj inicializirano spremenljivko kot v markReady($status). Literal v markReady('Ready') ni spremenljivka in povzroči napako. Prav tako ne podajaj običajnih izrazov, ki izračunajo vrednost; rezultat funkcije, ki vrača po referenci, je poseben dovoljen primer.
Tip parametra string se preveri ob vstopu v funkcijo, ne pa znova ob izhodu. : void pomeni, da funkcija ne vrne vrednosti; učinek je viden v podani spremenljivki. Znak & uporabi, kadar želiš spremenljivko iz klicne kode namenoma spremeniti, in to dokumentiraj, saj iz samega klica sprememba ni razvidna.
Primeri
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Rezultat
Ready Ready!
V prvi vrstici je `Ready`. Funkcija prek `$st` doda `!`, zato je v drugi vrstici `Ready!`. Če iz deklaracije odstraniš samo `&`, bo v obeh vrsticah `Ready`.
Povezane lekcije
- PHP · Lekcija 34 · Srednja · Različica: 3