Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje