(PHP 4, PHP 5, PHP 7, PHP 8)
func_get_args — Returns an array comprising a function's argument list
Gets an array of the function's argument list.
This function may be used in conjunction with func_get_arg() and func_num_args() to allow user-defined functions to accept variable-length argument lists.
У цієї функції немає параметрів.
Returns an array in which each element is a copy of the corresponding member of the current user-defined function's argument list.
Generates a warning if called from outside of a user-defined function.
Приклад #1 func_get_args() example
<?php
function foo()
{
$numargs = func_num_args();
echo "Number of arguments: $numargs \n";
if ($numargs >= 2) {
echo "Second argument is: " . func_get_arg(1) . "\n";
}
$arg_list = func_get_args();
for ($i = 0; $i < $numargs; $i++) {
echo "Argument $i is: " . $arg_list[$i] . "\n";
}
}
foo(1, 2, 3);
?>Поданий вище приклад виведе:
Number of arguments: 3 Second argument is: 2 Argument 0 is: 1 Argument 1 is: 2 Argument 2 is: 3
Приклад #2 func_get_args() example of byref and byval arguments
<?php
function byVal($arg) {
echo 'As passed : ', var_export(func_get_args()), PHP_EOL;
$arg = 'baz';
echo 'After change : ', var_export(func_get_args()), PHP_EOL;
}
function byRef(&$arg) {
echo 'As passed : ', var_export(func_get_args()), PHP_EOL;
$arg = 'baz';
echo 'After change : ', var_export(func_get_args()), PHP_EOL;
}
$arg = 'bar';
byVal($arg);
byRef($arg);
?>Поданий вище приклад виведе:
Зауваження:
Починаючи з PHP 8.0.0, сімейство функцій func_*() стало більш прозорим щодо названих параметрів, обробляючи їх так, ніби всі передані позиційно, а пропущеним аргументам призначаються стандартні значення. Ця функція ігнорує набір невідомих названих варіативних параметрів. Набір невідомих названих параметрів доступний через варіативний параметр.
Зауваження:
Якщо параметри передаються за посиланням, то будь-які зміни їхніх значень буде відображено у значеннях, які повертає ця функція. Починаючи з PHP 7, поточні значення також буде повернено, якщо параметри передано за значенням.
Зауваження: This function returns a copy of the passed arguments only, and does not account for default (non-passed) arguments.
... syntaxIf you want to get the arguments by reference, instead of func_get_args() you can simply use
<?php
function args_byref(&...$args) {
// Modify the $args array here
}
?>
Credits should go to Markus Malkusch for pointing this out on Stackoverflow.
https://stackoverflow.com/a/29181826/1426064