Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

Capturar una variable por referencia en una clausura: `use (&$MAP)`

`use (&$MAP)` permite que una función anónima lea y modifique el estado actual de `$MAP` en el ámbito donde se definió la función.

Versión: PHP 8.3; extension availability may vary

Sintaxis

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

En PHP 8.3, use (&$MAP) se escribe después de la lista de parámetros de una función anónima y antes del tipo de retorno opcional. $MAP es un nombre de variable normal; en el ejemplo contiene un array asociativo que asigna valores a claves. Aquí & indica una referencia, no una operación bit a bit.

El vínculo se establece al crear la clausura, en su ámbito de definición, no en el de quien la llama. Mientras se mantengan ambos vínculos, sustituir el array fuera se refleja dentro y modificar una entrada dentro se refleja fuera. En cambio, use ($MAP) captura por valor el array de enteros tal como estaba al crear la clausura. Una función de flecha (fn) captura automáticamente por valor las variables externas que utiliza.

Esta cláusula use no importa nombres de un espacio de nombres. Tampoco es un parámetro por referencia como en function (array &$map), que vincula una variable que se pasa al llamar. En el ejemplo, el único argumento es la clave.

La clausura puede conservar el acceso al estado capturado después de salir del ámbito donde se definió. Usar unset($MAP) fuera solo elimina el vínculo externo; volver a crear $MAP no la conecta a la clausura existente. Inicializa el mapa antes de capturarlo. Usa & solo cuando la función deba compartir estado con el código que la rodea.

Ejemplos

<?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

La primera lectura devuelve `1` del array capturado por valor. Tras sustituir el mapa, la clausura que captura por referencia ve `2` e incrementa la entrada existente `apples` hasta `3`. La lectura externa también da `3`. El ejemplo no requiere ninguna extensión adicional.

Lecciones relacionadas

  • PHP · Lección 36 · Intermedio · Versión: 3

Fuentes