array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'function.func-get-arg.php', 1 => 'func_get_arg', 2 => 'Return an item from the argument list', ), 'up' => array ( 0 => 'ref.funchand.php', 1 => 'Function handling Функції', ), 'prev' => array ( 0 => 'function.forward-static-call-array.php', 1 => 'forward_static_call_array', ), 'next' => array ( 0 => 'function.func-get-args.php', 1 => 'func_get_args', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/funchand/functions/func-get-arg.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

func_get_arg

(PHP 4, PHP 5, PHP 7, PHP 8)

func_get_arg — Return an item from the argument list

Опис

func_get_arg(int $position): 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.

Параметри

position

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

Значення, що повертаються

Returns the specified argument, or false on error.

Помилки/виключення

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

Приклади

Приклад #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(1, 2, 3);
?>

Поданий вище приклад виведе:

Number of arguments: 3
Second argument is: 2

Приклад #2 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);
?>

Поданий вище приклад виведе:


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

Примітки

Зауваження:

Починаючи з 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.

Прогляньте також