Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje