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

CKTIS / PHP

Parámetro por referencia `&$res`

El signo `&` delante de `$res` permite que una función modifique la variable que recibe en lugar de devolver un valor que la sustituya.

Versión: PHP 8.3; extension availability may vary

Sintaxis

function writeSum(int $left, int $right, int &$res): void { /* ... */ }
$total = 0;
writeSum(2, 3, $total);

En la firma de una función, &$res indica un parámetro por referencia. Durante la llamada, el nombre local $res es un alias de la variable que proporciona el código que llama. A diferencia del paso por valor habitual, asignar a $res cambia esa variable. res es un nombre normal, no una palabra clave; aquí & no indica un puntero ni un retorno por referencia.

Escribe & en la declaración, no en la llamada: writeSum(2, 3, $total). Para el argumento por referencia, usa una variable, no un literal como 0 ni una expresión calculada como 2 + 3. También puedes pasar una referencia devuelta por una función declarada para devolver por referencia.

En PHP 8.3, el tipo de int &$res se comprueba al entrar en la función, no al salir. Por tanto, la declaración por sí sola no garantiza que la variable siga conteniendo un int después de la llamada. Dentro de la función, unset($res) elimina solo el vínculo local, no la variable del código que llama.

Documenta qué argumentos puede sobrescribir la función. Si solo necesitas producir un resultado sin modificar la variable del código que llama, un return normal suele ser más claro. Esta sintaxis forma parte del lenguaje PHP y no requiere extensiones adicionales.

Ejemplos

<?php
declare(strict_types=1);

function writeSum(int $left, int $right, int &$res): void
{
    $res = $left + $right;
}

$total = 0;
echo "before: ", $total, "\n";
writeSum(2, 3, $total);
echo "after: ", $total, "\n";

Resultado

before: 0
after: 5

`$total` empieza con el valor `0`. La asignación mediante `$res` lo cambia a `5`, aunque `writeSum()` tiene tipo de retorno `void` y no devuelve ningún resultado.

Lecciones relacionadas

  • PHP · Lección 70 · Avanzado · Versión: 2

Fuentes