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

CKTIS / PHP

Parámetros pasados por referencia (&$tasks, &$used)

El signo `&` en los parámetros `$tasks` y `$used` permite que la función modifique ambas variables de quien la llama sin devolverlas.

Versión: PHP 8.3; extension availability may vary

Sintaxis

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

En PHP 8.3, escribe & justo antes del nombre de cada parámetro en la declaración: array &$tasks, array &$used. No escribas & en la llamada addTask($tasks, $used, 'Review'). Como $name no lleva &, su argumento se pasa por valor, que es el comportamiento predeterminado.

Durante la llamada, cada parámetro por referencia es un alias local de la variable pasada por quien llama a la función. Modificar un elemento del array o asignar un nuevo valor al parámetro cambia esa variable. Los cambios siguen siendo visibles después de la llamada, incluso con el tipo de retorno void. El & de un parámetro no significa que la función devuelva por referencia.

Lo más sencillo es pasar variables inicializadas. También se puede pasar el resultado de una función que devuelve por referencia. No uses un literal como [] ni el resultado de una expresión ordinaria en lugar de $tasks o $used: un literal en esa posición provoca un error.

La declaración array se comprueba al entrar en la función: pasar una variable que no contiene un array provoca un TypeError. PHP no vuelve a comprobar estos tipos de parámetros al salir. Documenta qué argumentos modifica la función, ya que no se indica en la llamada. Esta característica no requiere ninguna extensión adicional.

Ejemplos

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

Resultado

Review
used

Después de la llamada, `$tasks[0]` contiene `Review` y `$used['Review']` vale `true`. Por tanto, el script imprime `Review` y, en la línea siguiente, `used`.

Lecciones relacionadas

  • PHP · Lección 12 · Básico · Versión: 2

Fuentes