CKTIS / PHP
Parameter, podan po referenci: `&$res`
Znak `&` pred `$res` funkciji omogoči, da spremeni spremenljivko klicatelja, namesto da vrne vrednost, ki bi jo moral klicatelj sam shraniti vanjo.
Različica: PHP 8.3; extension availability may vary
Sintaksa
function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);V podpisu funkcije &$res označuje parameter, podan po referenci. Med klicem je lokalno ime $res drugo ime za spremenljivko klicatelja. V nasprotju z običajnim podajanjem po vrednosti prireditev v $res spremeni to spremenljivko. res je navadno ime, ne ključna beseda; & tu ne označuje niti kazalca niti vračanja po referenci.
Znak & zapiši v deklaraciji, ne pri klicu: writeSum(2, 3, $total). Kot argument, podan po referenci, uporabi spremenljivko, ne literala, kot je 0, ali izračunanega izraza, kot je 2 + 3. Podaš lahko tudi referenco, ki jo vrne funkcija, deklarirana za vračanje po referenci.
V PHP 8.3 se tip v int &$res preveri ob vstopu v funkcijo, ne pa znova ob vrnitvi. Sama deklaracija torej ne zagotavlja, da bo spremenljivka po klicu še vedno vsebovala vrednost tipa int. unset($res) znotraj funkcije odstrani le lokalno vezavo, ne spremenljivke klicatelja.
Dokumentiraj, katere argumente lahko funkcija prepiše. Če potrebuješ samo en rezultat in ti ni treba spremeniti spremenljivke klicatelja, je navaden return običajno jasnejši. Ta sintaksa je del jezika PHP in ne zahteva dodatne razširitve.
Primeri
<?php
declare(strict_types=1);
function writeSum(int $left, int $right, int &$res): void
{
$res = $left + $right;
}
$total = 0;
echo "before: ", $total, "\n";
writeSum(2, 3, $total);
echo "after: ", $total, "\n";
Rezultat
before: 0 after: 5
`$total` ima sprva vrednost `0`. Prireditev prek `$res` jo spremeni v `5`, čeprav ima `writeSum()` povratni tip `void` in ne vrne rezultata.
Povezane lekcije
- PHP · Lekcija 70 · Napredna · Različica: 2