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

CKTIS / PHP

Parámetro pasado por referencia (&$users)

El signo `&` delante del parámetro `$users` permite que la función modifique la variable de quien la llama sin devolver el array. En la llamada, la variable se pasa sin `&`.

Versión: PHP 8.3; extension availability may vary

Sintaxis

function addUser(array &$users, string $name): void { $users[] = $name; }
$users = ['Ada'];
addUser($users, 'Lin');

En array &$users, array indica el tipo del argumento y & marca el paso por referencia. El parámetro local y la variable de quien llama a la función son dos nombres para el mismo valor. Aquí & no representa un puntero ni una operación AND bit a bit, y la función no devuelve una referencia.

Llama a addUser($users, 'Lin') sin & y pasa una variable inicializada. También es válida una referencia devuelta por una función, pero no un array literal: addUser(['Ada'], 'Lin') provoca un Error. PHP comprueba el tipo array al entrar en la función, no al salir. Pasar una variable que contiene una cadena provoca un TypeError.

$users[] = $name añade un elemento al final, mientras que una asignación normal como $users = [] sustituiría todo el valor de la variable de quien llama. El cambio sigue visible después de la llamada, aunque la función no devuelve ningún valor (void). Sin &, el array se pasa por valor de forma predeterminada y, en este ejemplo, solo se modifica el array local.

Usa & cuando quieras modificar la variable de quien llama y documenta ese efecto, porque no se ve en la llamada. Si quien llama debe decidir si sustituye su array, recíbelo por valor y devuelve el array modificado.

Ejemplos

<?php
function addUser(array &$users, string $name): void
{
    $users[] = $name;
}

$users = ['Ada'];
echo implode(', ', $users), "\n";
addUser($users, 'Lin');
echo implode(', ', $users), "\n";

Resultado

Ada
Ada, Lin

El ejemplo usa PHP 8.3 en la consola, sin extensiones opcionales. Se espera `Ada` antes de la llamada y `Ada, Lin` después. Si quitas únicamente `&` de la declaración, se espera `Ada` en ambas líneas.

Lecciones relacionadas

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

Fuentes