CKTIS / PHP
Capturar uma variável por referência numa clausura: `use (&$MAP)`
`use (&$MAP)` permite a uma função anónima ler e alterar o estado atual de `$MAP` no âmbito em que a função foi definida.
Versão: PHP 8.3; extension availability may vary
Sintaxe
$increment = function (string $key) use (&$MAP): int {
return ++$MAP[$key];
};Em PHP 8.3, use (&$MAP) escreve-se depois da lista de parâmetros de uma função anónima e antes do tipo de retorno opcional. $MAP é um nome de variável comum; no exemplo, contém um array associativo que associa chaves a valores. Aqui, & indica uma referência, não uma operação bit a bit.
A ligação é estabelecida quando a clausura é criada, no âmbito da definição, não no âmbito da chamada. Enquanto ambas as ligações existirem, a substituição do array no exterior é visível no interior e a alteração de uma entrada no interior é visível no exterior. Em contraste, use ($MAP) captura por valor o array de inteiros tal como se encontra no momento da criação. Uma função de seta (fn) captura automaticamente por valor as variáveis externas que utiliza.
Esta cláusula use não serve para importar nomes de um espaço de nomes. Também não é um parâmetro por referência como em function (array &$map), que estabelece uma ligação a uma variável passada na chamada. No exemplo, o único argumento é a chave.
A clausura pode manter o acesso ao estado capturado mesmo depois de se sair do âmbito em que foi definida. Usar unset($MAP) no exterior remove apenas a ligação externa; voltar a criar $MAP não a liga à clausura existente. Inicializa o mapa antes de o capturar. Usa & apenas quando a função tiver de partilhar estado com o código circundante.
Exemplos
<?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";
Resultado
1 3 3
A primeira leitura dá `1`, proveniente do array capturado por valor. Depois de substituir o mapa, a clausura que captura por referência lê `2` e incrementa a entrada existente `apples` para `3`. A leitura no exterior também dá `3`. O exemplo não requer extensões adicionais.
Lições relacionadas
- PHP · Lição 36 · Intermédio · Versão: 3