Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Parametro per riferimento `&$res`

Il simbolo `&` prima di `$res` permette alla funzione di modificare la variabile fornita dal chiamante anziché restituire un valore sostitutivo.

Versione: PHP 8.3; extension availability may vary

Sintassi

function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);

Nella firma di una funzione, &$res indica un parametro per riferimento. Durante la chiamata, il nome locale $res è un alias della variabile del chiamante. A differenza del normale passaggio per valore, assegnare un valore a $res modifica quella variabile. res è un nome come un altro, non una parola chiave; qui & non indica né un puntatore né una restituzione per riferimento.

Scrivi & nella dichiarazione, non nella chiamata: writeSum(2, 3, $total). Per l’argomento passato per riferimento, usa una variabile, non un letterale come 0 o un’espressione calcolata come 2 + 3. Puoi passare anche un riferimento restituito da una funzione dichiarata per restituire per riferimento.

In PHP 8.3, il tipo in int &$res viene controllato all’ingresso nella funzione, non di nuovo all’uscita. La dichiarazione da sola non garantisce quindi che la variabile contenga ancora un int dopo la chiamata. All’interno della funzione, unset($res) rimuove solo il legame locale, non la variabile del chiamante.

Documenta quali argomenti la funzione può sovrascrivere. Se devi produrre un solo risultato senza modificare la variabile del chiamante, in genere un normale return è più chiaro. Questa sintassi fa parte del linguaggio PHP e non richiede estensioni aggiuntive.

Esempi

<?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";

Risultato

before: 0
after: 5

All’inizio `$total` vale `0`. L’assegnazione tramite `$res` lo porta a `5`, anche se `writeSum()` ha tipo di ritorno `void` e non restituisce alcun risultato.

Lezioni correlate

  • PHP · Lezione 70 · Avanzato · Versione: 2

Fonti