CKTIS / PHP
Parametro passato per riferimento (`&$st`)
Il simbolo `&` prima del nome del parametro consente alla funzione di modificare la variabile del chiamante. Scrivi `&$st` nella dichiarazione, ma chiama la funzione senza `&`: `markReady($status)`.
Versione: PHP 8.3; extension availability may vary
Sintassi
function markReady(string &$st): void { $st .= '!'; }
markReady($status);In PHP 8.3, string &$st indica che l’argomento viene passato per riferimento. Nella funzione, $st è un alias locale di $status, la variabile del chiamante: entrambi i nomi si riferiscono allo stesso valore. Una scrittura tramite $st modifica quindi $status e la modifica resta visibile al termine della funzione. Senza & il passaggio avviene per valore per impostazione predefinita, quindi un’assegnazione al parametro non modifica la variabile del chiamante.
Metti & prima del nome del parametro nella dichiarazione, non nella chiamata. Passa una variabile inizializzata, come in markReady($status). Il letterale in markReady('Ready') non è una variabile e causa un errore. Non passare nemmeno espressioni comuni che calcolano un valore; il risultato di una funzione che restituisce per riferimento è un caso distinto ammesso.
Il tipo string del parametro viene controllato all’ingresso nella funzione, ma non di nuovo all’uscita. : void significa che la funzione non restituisce alcun valore; l’effetto si vede nella variabile passata. Usa & se intendi modificare la variabile del chiamante e documenta questo comportamento, perché non è evidente dalla sola chiamata.
Esempi
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Risultato
Ready Ready!
La prima riga mostra `Ready`. La funzione aggiunge `!` tramite `$st`, quindi la seconda riga mostra `Ready!`. Se rimuovi solo `&` dalla dichiarazione, entrambe le righe mostrano `Ready`.
Lezioni correlate
- PHP · Lezione 34 · Intermedio · Versione: 3