func_get_args
(PHP 4, PHP 5, PHP 7)
func_get_args - 返回一个包含函数参数列表的数组
描述
array func_get_args ( void )
获取函数参数列表的数组。
该函数可以与func_get_arg()和func_num_args()一起使用,以允许用户定义的函数接受可变长度参数列表。
返回值
返回一个数组,其中每个元素都是当前用户定义函数参数列表的相应成员的副本。
Changelog
版本 | 描述 |
---|---|
5.3.0 | 该功能现在可以用于参数列表中。 |
5.3.0 | 如果通过调用include或require从调用文件中的函数内包含的文件的最外层范围调用此函数,它现在会生成警告并返回FALSE。 |
Errors/Exceptions
如果从用户定义的函数外部调用,则会生成警告。
示例
Example #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
Example #2 func_get_args() example before and after PHP 5.3
test.php
<?php
function?foo()?{
????include?'./fga.inc';
}
foo('First?arg',?'Second?arg');
?>
fga.inc
<?php
$args?=?func_get_args();
var_export($args);
?>
PHP 5.3之前的输出:
array (
0 => 'First arg',
1 => 'Second arg',
)
在PHP 5.3和更高版本中输出:
Warning: func_get_args(): Called from the global scope - no function
context in /home/torben/Desktop/code/ml/fga.inc on line 3
false
Example #3 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 7输出示例:
As passed : array (
0 => 'bar',
)
After change : array (
0 => 'baz',
)
As passed : array (
0 => 'bar',
)
After change : array (
0 => 'baz',
)
上面的例子在PHP 5中输出:
As passed : array (
0 => 'bar',
)
After change : array (
0 => 'bar',
)
As passed : array (
0 => 'bar',
)
After change : array (
0 => 'baz',
)
笔记
注意:由于此函数依赖于当前范围来确定参数详细信息,因此它不能在5.3.0之前的版本中用作函数参数。如果必须传递此值,则应将结果分配给一个变量,并且应该传递该变量。
注意:如果参数是通过引用传递的,则参数的任何更改都会反映在此函数返回的值中。从PHP 7开始,如果参数是按值传递的,那么当前值也会被返回。
注意:此函数仅返回传递参数的副本,并且不包含默认(未传递)参数。
另请参阅
- ... syntax in PHP 5.6+
- func_get_arg()
- func_num_args()
- ReflectionFunctionAbstract::getParameters()
← func_get_arg
func_num_args →
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com