Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Catturare una variabile per riferimento in una closure: `use (&$MAP)`

`use (&$MAP)` consente a una funzione anonima di leggere e modificare lo stato corrente di `$MAP` nell’ambito in cui è stata definita.

Versione: PHP 8.3; extension availability may vary

Sintassi

$increment = function (string $key) use (&$MAP): int {
    return ++$MAP[$key];
};

In PHP 8.3, use (&$MAP) si scrive dopo l’elenco dei parametri di una funzione anonima e prima dell’eventuale tipo di ritorno. $MAP è un normale nome di variabile; nell’esempio contiene un array associativo che associa chiavi a valori. Qui & indica un riferimento, non un’operazione bit a bit.

Il legame si stabilisce quando viene creata la closure, nell’ambito di definizione, non in quello di chi la invoca. Finché entrambi i legami restano attivi, la sostituzione dell’array all’esterno è visibile all’interno e la modifica di un elemento all’interno è visibile all’esterno. Invece use ($MAP) cattura per valore l’array di interi così com’è al momento della creazione. Una funzione freccia (fn) cattura automaticamente per valore le variabili esterne che usa.

Questa clausola use non è un’importazione da uno spazio dei nomi. Non è nemmeno un parametro per riferimento come in function (array &$map), che si lega a una variabile passata al momento della chiamata. Nell’esempio l’unico argomento è la chiave.

La closure può mantenere l’accesso allo stato catturato anche dopo l’uscita dall’ambito di definizione. unset($MAP) all’esterno rimuove solo il legame esterno; ricreare $MAP non la ricollega alla closure esistente. Inizializza la mappa prima di catturarla. Usa & solo quando la funzione deve condividere lo stato con il codice circostante.

Esempi

<?php
$MAP = ['apples' => 1];

$readSnapshot = function () use ($MAP): int {
    return $MAP['apples'];
};

$increment = function (string $key) use (&$MAP): int {
    return ++$MAP[$key];
};

$MAP = ['apples' => 2];
echo $readSnapshot(), "\n";
echo $increment('apples'), "\n";
echo $MAP['apples'], "\n";

Risultato

1
3
3

La prima lettura restituisce `1` dall’array catturato per valore. Dopo la sostituzione della mappa, la closure che cattura per riferimento vede `2` e incrementa la voce esistente `apples` fino a `3`. Anche la lettura esterna dà `3`. L’esempio non richiede estensioni aggiuntive.

Lezioni correlate

  • PHP · Lezione 36 · Intermedio · Versione: 3

Fonti