Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Parametri passati per riferimento (&$tasks, &$used)

Con `&` davanti ai parametri `$tasks` e `$used`, la funzione può modificare entrambe le variabili del chiamante senza restituirle.

Versione: PHP 8.3; extension availability may vary

Sintassi

function addTask(array &$tasks, array &$used, string $name): void { /* ... */ }
addTask($tasks, $used, 'Review');

In PHP 8.3, scrivi & subito prima del nome di ciascun parametro nella dichiarazione: array &$tasks, array &$used. Non scrivere & nella chiamata addTask($tasks, $used, 'Review'). Dato che $name non ha &, il suo argomento viene passato per valore, come avviene per impostazione predefinita.

Durante la chiamata, ogni parametro per riferimento è un alias locale della variabile passata dal chiamante. Modificare un elemento dell’array o assegnare un nuovo valore al parametro modifica la variabile del chiamante. Le modifiche restano visibili dopo la chiamata, anche con un tipo di ritorno void. Il simbolo & su un parametro non indica una restituzione per riferimento.

Il modo più semplice è passare variabili inizializzate. Si può passare anche il risultato di una funzione che restituisce per riferimento. Non usare un letterale come [] né il risultato di una normale espressione al posto di $tasks o $used: un letterale in quella posizione causa un errore.

Il tipo array viene controllato all’ingresso nella funzione: passare una variabile che non contiene un array causa un TypeError. PHP non verifica di nuovo questi tipi di parametro all’uscita. Documenta quali argomenti modifica la funzione, perché non si vede dalla chiamata. Questa funzionalità non richiede estensioni aggiuntive.

Esempi

<?php

function addTask(array &$tasks, array &$used, string $name): void
{
    $tasks[] = $name;
    $used[$name] = true;
}

$tasks = [];
$used = [];
addTask($tasks, $used, 'Review');

echo $tasks[0], "\n";
echo $used['Review'] ? "used\n" : "unused\n";

Risultato

Review
used

Dopo la chiamata, `$tasks[0]` contiene `Review` e `$used['Review']` vale `true`. Lo script stampa quindi `Review` e, sulla riga successiva, `used`.

Lezioni correlate

  • PHP · Lezione 12 · Base · Versione: 2

Fonti