func_get_args

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

    func_get_args — Returns an array comprising a function's argument list

    Опис

    func_get_args(): array

    Gets an array of the function's argument list.

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

    Параметри

    У цієї функції немає параметрів.

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

    Returns an array in which each element is a copy of the corresponding member of the current user-defined function's argument list.

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

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

    Приклади

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

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

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


    As passed : array (
    0 => 'bar',
    )
    After change : array (
    0 => 'baz',
    )
    As passed : array (
    0 => 'bar',
    )
    After change : array (
    0 => '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.

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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    13
    cobrattila at gmail dot com
    5 years ago
    If you want to get the arguments by reference, instead of func_get_args() you can simply use

    <?php
    function args_byref(&...$args) {
    // Modify the $args array here
    }
    ?>

    Credits should go to Markus Malkusch for pointing this out on Stackoverflow.
    https://stackoverflow.com/a/29181826/1426064
    ＋add a note
    To Top