func_get_args
(PHP 4, PHP 5, PHP 7, PHP 8)
func_get_args — Devuelve los argumentos de una función en forma de array
Descripción
function func_get_args():
array
func_get_arg() puede ser utilizado conjuntamente con
func_num_args() y func_get_args()
para permitir que las funciones de usuario acepten un número variable de argumentos.
Parámetros
Esta función no contiene ningún parámetro.
Valores devueltos
Devuelve un array donde cada elemento es una copia del miembro correspondiente de la lista
de argumentos de la función.
Errores/Excepciones
Generará una advertencia si es llamada fuera de una función.
Ejemplos
Ejemplo #1 Ejemplo con func_get_args()
<?php
function foo()
{
$numargs = func_num_args();
echo "Número de argumentos : $numargs \n";
if ($numargs >= 2) {
echo "El segundo argumento es : " . func_get_arg(1) . "\n";
}
$arg_list = func_get_args();
for ($i = 0; $i < $numargs; $i++) {
echo "El argumento $i es : " . $arg_list[$i] . "\n";
}
}
foo(1, 2, 3);
?>
El ejemplo anterior mostrará:
Número de argumentos : 3
El segundo argumento es : 2
El argumento 0 es : 1
El argumento 1 es : 2
El argumento 2 es : 3
Ejemplo #2 Ejemplo func_get_args() con argumentos por referencia y por valor
<?php
function byVal($arg) {
echo 'Tal como se pasó : ', var_export(func_get_args()), PHP_EOL;
$arg = 'baz';
echo 'Después del cambio : ', var_export(func_get_args()), PHP_EOL;
}
function byRef(&$arg) {
echo 'Tal como se pasó : ', var_export(func_get_args()), PHP_EOL;
$arg = 'baz';
echo 'Después del cambio : ', var_export(func_get_args()), PHP_EOL;
}
$arg = 'bar';
byVal($arg);
byRef($arg);
?>
El ejemplo anterior mostrará:
Tel que passé : array (
0 => 'bar',
)
Après changement : array (
0 => 'baz',
)
Tel que passé : array (
0 => 'bar',
)
Après changement : array (
0 => 'baz',
)
Notas
Nota:
A partir de PHP 8.0.0, la familia de funciones func_*() está diseñada para ser esencialmente
transparente con respecto a los argumentos nombrados, tratando los argumentos como si fueran todos pasados
de manera posicional, y los argumentos faltantes son reemplazados con sus valores por defecto.
Esta función ignora la colección de argumentos variádicos nombrados desconocidos.
Los argumentos nombrados que son recolectados solo son accesibles a través del parámetro variádico.
Nota: Si los argumentos son pasados por referencia,
todas sus modificaciones serán reflejadas en los valores devueltos por esta función. A partir de PHP 7,
los valores actuales también serán devueltos si los argumentos son pasados por su valor.
Nota:
Esta función devuelve únicamente una copia de los argumentos pasados, y no cuenta
ni trata los argumentos por defecto (no pasados).