CKTIS / PHP
Parametro di tipo array passato per riferimento: `array &$items`
`array &$items` richiede un array all’inizio della chiamata e consente alla funzione di modificare la variabile del chiamante senza restituire un risultato.
Versione: PHP 8.3; extension availability may vary
Sintassi
function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);In function markReady(array &$items): void, array dichiara il tipo in ingresso, $items è il nome locale del parametro e & indica il passaggio per riferimento. Il parametro è un alias della variabile del chiamante: sia la scrittura in $items[0] sia l’assegnazione di un nuovo valore a $items sono visibili al chiamante, anche con : void.
Inizializza una variabile con un array e chiama markReady($cart). Il simbolo & si scrive nella dichiarazione, non nella chiamata. Non passare direttamente un array letterale come ['draft'] né il normale risultato di una funzione che restituisce per valore; puoi passare un risultato restituito per riferimento. Se la variabile fornita non contiene un array, PHP solleva un TypeError all’ingresso. Il tipo non viene ricontrollato al ritorno, quindi un’assegnazione tramite $items può perfino cambiare il tipo di una normale variabile del chiamante.
Senza &, array $items è passato per valore: sostituire un elemento che contiene una semplice stringa, come nell’esempio, non modifica l’array del chiamante. Non è una copia profonda: i riferimenti già presenti nell’array possono continuare a condividere valori. Se la modifica non fa parte del contratto della funzione, ricevi l’array per valore e restituisci esplicitamente il risultato.
unset($items) rimuove il legame locale, non la variabile del chiamante. Invece foreach ($items as &$item) crea un riferimento distinto a un elemento. Usa unset($item) dopo un ciclo di questo tipo, così una successiva scrittura in $item non sovrascriverà l’ultimo elemento visitato.
Esempi
<?php
function markReadyCopy(array $items): void
{
$items[0] = 'ready';
}
function markReady(array &$items): void
{
$items[0] = 'ready';
}
$cart = ['draft'];
markReadyCopy($cart);
echo $cart[0], "\n";
markReady($cart);
echo $cart[0], "\n";
Risultato
draft ready
Entrambe le funzioni scrivono `ready` all’indice `0`. Dopo la chiamata per valore `$cart[0]` contiene ancora `draft`; dopo quella per riferimento contiene `ready`.
Lezioni correlate
- PHP · Lezione 19 · Avanzato · Versione: 2