CKTIS / PHP
Parameter odovzdávaný odkazom `&$res`
Znak `&` pred `$res` umožňuje funkcii zmeniť premennú volajúceho namiesto toho, aby vracala hodnotu, ktorú by do nej volajúci musel uložiť.
Verzia: PHP 8.3; extension availability may vary
Syntax
function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);V signatúre funkcie označuje &$res parameter odovzdávaný odkazom. Počas volania je lokálny názov $res aliasom premennej volajúceho. Na rozdiel od bežného odovzdania hodnotou priradenie do $res zmení túto premennú. res je obyčajný názov, nie kľúčové slovo; & tu neoznačuje ukazovateľ ani návrat odkazom.
Znak & píš v deklarácii, nie pri volaní: writeSum(2, 3, $total). Ako argument odovzdávaný odkazom použi premennú, nie literál ako 0 ani vypočítaný výraz ako 2 + 3. Odovzdať možno aj odkaz vrátený funkciou, ktorá je deklarovaná tak, aby vracala odkaz.
V PHP 8.3 sa typ v int &$res kontroluje pri vstupe do funkcie, nie znova pri návrate. Samotná deklarácia preto nezaručuje, že premenná bude po volaní stále obsahovať hodnotu typu int. unset($res) vo funkcii odstráni iba lokálnu väzbu, nie premennú volajúceho.
Zdokumentuj, ktoré argumenty môže funkcia prepísať. Ak potrebuješ len jeden výsledok a nemusíš meniť premennú volajúceho, obyčajný return býva prehľadnejší. Táto syntax je súčasťou PHP a nevyžaduje žiadne ďalšie rozšírenie.
Príklady
<?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";
Výsledok
before: 0 after: 5
`$total` má spočiatku hodnotu `0`. Priradenie cez `$res` ju zmení na `5`, hoci má `writeSum()` návratový typ `void` a nevracia žiadny výsledok.
Súvisiace lekcie
- PHP · Lekcia 70 · Pokročilá · Verzia: 2