array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.func-get-arg.php', 1 => 'func_get_arg', 2 => 'Возвращает элемент из списка аргументов', ), 'up' => array ( 0 => 'ref.funchand.php', 1 => 'Функции управления функциями', ), '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' => 'ru', '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 — Возвращает элемент из списка аргументов

Описание

func_get_arg(int $position): mixed

Функция получает аргумент из списка аргументов пользовательской функции по заданной позиции.

Функцию допускается использовать совместно с функциями func_get_args() и func_num_args(), чтобы создавать функции с переменным количеством аргументов.

Список параметров

position

Смещение аргумента. Аргументы функции отсчитываются с нуля.

Возвращаемые значения

Функция возвращает аргумент по позиции или false, если возникла ошибка.

Ошибки

Функция генерирует предупреждение при вызове из-за пределов определения функции или если значение позиции position больше количества аргументов, которые действительно передали.

Примеры

Пример #1 Пример использования функции func_get_arg()

<?php

function foo()
{
$numargs = func_num_args();

echo "Количество аргументов: $numargs\n";

if ($numargs >= 2) {
echo "Второй аргумент: " . func_get_arg(1) . "\n";
}
}

foo(1, 2, 3);

?>

Результат выполнения приведённого примера: 

Количество аргументов: 3
Второй аргумент: 2

Пример #2 Пример передачи в функцию func_get_arg() аргументов по ссылке и по значению

<?php

function byVal($arg) {
echo 'Передан : ', var_export(func_get_arg(0)), PHP_EOL;
$arg = 'baz';
echo 'После изменения : ', var_export(func_get_arg(0)), PHP_EOL;
}

function byRef(&$arg) {
echo 'Передан : ', var_export(func_get_arg(0)), PHP_EOL;
$arg = 'baz';
echo 'После изменения : ', var_export(func_get_arg(0)), PHP_EOL;
}

$arg = 'bar';
byVal($arg);
byRef($arg);

?>

Результат выполнения приведённого примера:


Передан : 'bar'
После изменения : 'baz'
Передан : 'bar'
После изменения : 'baz'

Примечания

Замечание:

Начиная с PHP 8.0.0 семейство функций func_*() стремится к большей прозрачности в отношении именованных аргументов, поскольку обрабатывают аргументы так, как если бы каждый из них передали позиционно, а аргументы, которые пропустили, заменяют значениями по умолчанию. Функция игнорирует коллекцию неизвестных именованных аргументов переменной длины. Доступ к собранным неизвестным именованным аргументам получают только через параметр с переменным количеством аргументов.

Замечание:

Изменения аргументов отразятся на значениях, которые возвращает функция, если аргументы передали по ссылке. В PHP 7 также вернутся текущие значения, если аргументы передали по значению.

Замечание: Функция возвращает только копии аргументов, которые передали, и не возвращает значения по умолчанию для аргументов, которые не передавали.

Смотрите также