CKTIS / PHP
Parametr předávaný odkazem `&$res`
Znak `&` před `$res` umožňuje funkci změnit proměnnou volajícího, místo aby vracela hodnotu, kterou by do ní volající musel uložit.
Verze: PHP 8.3; extension availability may vary
Syntaxe
function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);V signatuře funkce označuje &$res parametr předávaný odkazem. Během volání je lokální název $res aliasem proměnné volajícího. Na rozdíl od běžného předání hodnotou přiřazení do $res změní tuto proměnnou. res je obyčejný název, nikoli klíčové slovo; & zde neoznačuje ukazatel ani návrat odkazem.
Piš & v deklaraci, ne při volání: writeSum(2, 3, $total). Jako argument předávaný odkazem použij proměnnou, ne literál jako 0 ani počítaný výraz jako 2 + 3. Předat lze také odkaz vrácený funkcí, která je deklarována s návratem odkazem.
V PHP 8.3 se typ v int &$res kontroluje při vstupu do funkce, ne znovu při návratu. Samotná deklarace tedy nezaručuje, že proměnná po volání stále obsahuje hodnotu typu int. unset($res) uvnitř funkce zruší pouze lokální vazbu, nikoli proměnnou volajícího.
Zdokumentuj, které argumenty může funkce přepsat. Pokud potřebuješ jen jeden výsledek a nemusíš měnit proměnnou volajícího, bývá obyčejný return přehlednější. Tato syntaxe je součástí PHP a nevyžaduje žádné další rozšíření.
Pří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ýsledek
before: 0 after: 5
`$total` má zpočátku hodnotu `0`. Přiřazení přes `$res` ji změní na `5`, i když má `writeSum()` návratový typ `void` a žádný výsledek nevrací.
Související lekce
- PHP · Lekce 70 · Pokročilá · Verze: 2