CKTIS / PHP
Parámetro pasado por referencia (`&$st`)
El signo `&` delante del nombre del parámetro permite que la función modifique la variable del código que la llama. Escribe `&$st` en la declaración y llama a la función sin `&`: `markReady($status)`.
Versión: PHP 8.3; extension availability may vary
Sintaxis
function markReady(string &$st): void { $st .= '!'; }
markReady($status);En PHP 8.3, string &$st indica que el argumento se pasa por referencia. Dentro de la función, $st es un alias local de $status, la variable del código que hace la llamada: ambos nombres se refieren al mismo valor. Escribir a través de $st cambia $status, y el cambio sigue siendo visible cuando termina la función. Sin &, el paso es por valor de forma predeterminada, así que asignar un valor al parámetro no modifica la variable original.
Coloca & delante del nombre del parámetro en la declaración, no en la llamada. Pasa una variable inicializada, como en markReady($status). El literal de markReady('Ready') no es una variable y provoca un error. Tampoco pases expresiones ordinarias que calculen un valor; el resultado de una función que devuelve por referencia es un caso distinto que sí se permite.
El tipo string del parámetro se comprueba al entrar en la función, pero no se vuelve a comprobar al salir. : void significa que la función no devuelve ningún valor; el efecto se ve en la variable pasada. Usa & cuando quieras modificar esa variable y documenta el cambio, porque la llamada por sí sola no lo indica.
Ejemplos
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Resultado
Ready Ready!
La primera línea muestra `Ready`. La función añade `!` a través de `$st`, así que la segunda línea muestra `Ready!`. Si quitas solo `&` de la declaración, ambas líneas muestran `Ready`.
Lecciones relacionadas
- PHP · Lección 34 · Intermedio · Versión: 3