Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti