func_num_args

(PHP 4, PHP 5, PHP 7)
Returns the number of arguments passed to the function
int func_num_args ( void )

Gets the number of arguments passed to the function.

This function may be used in conjunction with func_get_arg() and func_get_args() to allow user-defined functions to accept variable-length argument lists.

Returns:

Returns the number of arguments passed into the current user-defined function.

Exception:

Generates a warning if called from outside of a user-defined function.

Changelog:
5.3.0

This function can now be used in parameter lists.

5.3.0

If this function is called from the outermost scope of a file which has been included by calling include or require from within a function in the calling file, it now generates a warning and returns -1.

Notes:

Because this function depends on the current scope to determine parameter details, it cannot be used as a function parameter in versions prior to 5.3.0. If this value must be passed, the results should be assigned to a variable, and that variable should be passed.

Examples:
func_num_args() example
1
2
3
4
5
6
7
8
9
<?php
function foo()
{
    $numargs = func_num_args();
    echo "Number of arguments: $numargs\n";
}
 
foo(1, 2, 3);   
?>

The above example will output:

Number of arguments: 3
func_num_args() example before and after PHP 5.3
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
test.php
<?php
function foo() {
    include './fna.php';
}
 
foo('First arg''Second arg');
?>
 
fna.php
<?php
 
$num_args = func_num_args();
var_export($num_args);
 
?>

Output previous to PHP 5.3:

2

Output in PHP 5.3 and later will be something similar to:

Warning: func_num_args():  Called from the global scope - no function
context in /home/torben/Desktop/code/ml/fna.php on line 3
-1
See also:

... syntax in PHP 5.6+ -

func_get_arg() -

func_get_args() -

ReflectionFunctionAbstract::getNumberOfParameters() -

doc_php
2025-01-10 15:47:30
Comments
Leave a Comment

Please login to continue.