func_get_arg

(PHP 4, PHP 5, PHP 7)

func_get_argReturn an item from the argument list

Descrierea

func_get_arg ( int $arg_num ) : mixed

Gets the specified argument from a user-defined function's argument list.

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

Parametri

arg_num

The argument offset. Function arguments are counted starting from zero.

Valorile întoarse

Returns the specified argument, or false on error.

Erori/Excepții

Generates a warning if called from outside of a user-defined function, or if arg_num is greater than the number of arguments actually passed.

Exemple

Example #1 func_get_arg() 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";
     }
}

foo(123);
?>

Exemplul de mai sus va afișa:

Number of arguments: 3
Second argument is: 2

Example #2 func_get_arg() example before and after PHP 5.3

test.php
<?php
function foo() {
    include 
'./fga.inc';
}

foo('First arg''Second arg');
?>

fga.inc
<?php

$arg 
func_get_arg(1);
var_export($arg);

?>

Output previous to PHP 5.3:

'Second arg'

Output in PHP 5.3 and later:

Warning: func_get_arg():  Called from the global scope - no function
context in /home/torben/Desktop/code/ml/fga.inc on line 3
false

Example #3 func_get_arg() example of byref and byval arguments

<?php
function byVal($arg) {
    echo 
'As passed     : 'var_export(func_get_arg(0)), PHP_EOL;
    
$arg 'baz';
    echo 
'After change  : 'var_export(func_get_arg(0)), PHP_EOL;
}

function 
byRef(&$arg) {
    echo 
'As passed     : 'var_export(func_get_arg(0)), PHP_EOL;
    
$arg 'baz';
    echo 
'After change  : 'var_export(func_get_arg(0)), PHP_EOL;
}

$arg 'bar';
byVal($arg);
byRef($arg);
?>

Exemplul de mai sus va afișa în PHP 7:


As passed : 'bar'
After change : 'baz'
As passed : 'bar'
After change : 'baz'

Exemplul de mai sus va afișa în PHP 5:


As passed : 'bar'
After change : 'bar'
As passed : 'bar'
After change : 'baz'

Note

Notă:

Deoarece această funcție își determină detaliile parametrilor în dependență de circumstanță, ea nu poate fi utilizată în calitate de parametru-funcție în versiunile anterioare 5.3.0. Dacă trebuie transmisă această valoare, atunci rezultatele trebuie atribuite unei variabile, și această variabilă trebuie transmisă.

Notă:

Dacă argumentele sunt transmise prin referință atunci orice schimbare a lor va fi reflectată în valorile întoarse de această funcție. Începând cu PHP 7 valorile curente vor fi întoarse de asemenea și atunci când argumentele sunt transmise prin valoare.

Notă: This function returns a copy of the passed arguments only, and does not account for default (non-passed) arguments.