>PHP: func_get_args

DescripciÃ³n

array func_get_args ( void )

Devuelve una matriz en la cual cada elemento es una copia del miembro correspondiente de la lista de argumentos de la funciÃ³n definida por el usuario actual. func_get_args() generarÃ¡ una advertencia si es llamada desde afuera de una definiciÃ³n de funciÃ³n. Esta funciÃ³n no puede ser usada directamente como un parÃ¡metro de funciÃ³n. En su lugar, su resultado puede ser asignado a una variable, la cual puede ser pasada a la funciÃ³n.

Nota: Esta funciÃ³n devuelve una copia de los argumentos pasados Ãºnicamente, y no toma en cuenta las argumentas predeterminados (no pasados).

Nota: Because this function depends on the current scope to determine parameter details, it cannot be used as a function parameter. If you must pass this value, assign the results to a variable, and pass the variable.


<?php

function foo()

{

    $num_args = func_num_args();

    echo "Numero de argumentos: $num_args<br />\n";

    if ($num_args >= 2) {

        echo "El segundo argumento es: " . func_get_arg(1) . "<br />\n";

    }

    $lista_args = func_get_args();

    for ($i = 0; $i < $num_args; $i++) {

        echo "El argumento $i es: " . $lista_args[$i] . "<br />\n";

    }

}



foo(1, 2, 3);

?>

Es posible usar func_get_args() en conjunto con func_num_args() y func_get_arg() para permitir que funciones definidas por el usuario acepten listas de argumentos de longitud variable.

add a note User Contributed Notes
func_get_args

bew
31-Mar-2006 07:55


A more concise way of expressing my idea from the previous post (I'd forgotten about array_slice()):



<?php

function func_get_default_args($a) {

    $args = array_slice(func_get_args(), 1);

    return array_merge($args, array_slice($a, sizeof($args)));

}



function foo($a = 1, $b = 2, $c = 3) {

    print_r(func_get_default_args(func_get_args(), $a, $b, $c));

}



// prints: Array ( [0] => a [1] => b [2] => 3 )

foo('a', 'b');

?>

Nathan Ostgard
06-Dec-2005 10:14


If you're using PHP5, the variable number of argument functions all return the objects by reference - and not a copy of the object, as this leads you to believe.

robert at defore dot st
15-Feb-2005 12:47


# Another attempt at named args (perl-inspired):



# list_to_assoc('key', 'value', 'key', 'value', ...) =>

#     pairs[]

function list_to_assoc() {

    $list = func_get_args();

    $assoc = array();



    while ($list and count($list) > 1) {

        $assoc[array_shift($list)] = array_shift($list);

    }



    if ($list) { $assoc[] = $list[0]; }



    return $assoc;

}



# Usage:



function example($required) {

    $args = func_get_args(); array_shift($args); # drop 'required'

    $rest = list_to_assoc($args);

    echo "$required\n" . $rest['comment']; 

}



example("This is required...", 

        'comment', 'this is not.'); # this is like 'comment' => 'this is not'

T.M.
04-Nov-2004 07:24


Simple function to calculate average value using dynamic arguments:

<?php

function average(){

    return array_sum(func_get_args())/func_num_args();

}

print average(10, 15, 20, 25); // 17.5

?>

volte6 at drunkduck dot com
30-Sep-2004 02:54


For those who have a use for a C style enum() function:



//*******************************************

// void enum();

// enumerates constants for unique values guarenteed.

function enum()

{

  $i=0;

  $ARG_ARR = func_get_args();

  if (is_array($ARG_ARR))

  {

    foreach ($ARG_ARR as $CONSTANT)

    {

      define ($CONSTANT, ++$i);

    }

  }

}



// USAGE:

enum(ERR_USER_EXISTS, ERR_OLD_POST);



// etc. etc.

//*******************************************



this can be used for error codes etc.

I deliberately skipped the 0 (zero) define, which could be useful for error checking.

mark at manngo dot net
23-Mar-2003 11:13


You can also fake named arguments using eval:



function test()

{   foreach (func_get_args() as $k=>$arg) eval ("\$$arg;");

    echo "$a plus $b gives ".($a+$b);

}



test("a=3","b=4");

fbeyer at clickhand dot de dot noSpamPlease
19-Jan-2002 08:02


Another way of passing references with a dynamic number of arguments: (This example is limited to 10 arguments)



<?php

define('NULL_ARG', 'DUMMY_ARGUMENT');



function refArg($arg0 = NULL_ARG,

                $arg1 = NULL_ARG,

                $arg2 = NULL_ARG,

                $arg3 = NULL_ARG,

                $arg4 = NULL_ARG,

                $arg5 = NULL_ARG,

                $arg6 = NULL_ARG,

                $arg7 = NULL_ARG,

                $arg8 = NULL_ARG,

                $arg9 = NULL_ARG)

{

    for ($args=array(), $i=0; $i < 10; $i++) {

        $name = 'arg' . $i;

        if ($i < func_num_args()) {

            $args[$i] = &$$name;

        }

        unset($$name, $name);

    }



    $args[0] = 'Modified.';

}



$test = 'Not modified.<br>';

refArg(&$test);



echo $test; // Prints 'Modified'

?>

daveNO at ovumSPAMdesign dot com
17-Sep-2001 11:29


<?php


// How to simulate named parameters in PHP.


// By Dave Benjamin <dave@ovumdesign.com>





// Turns the array returned by func_get_args() into an array of name/value


// pairs that can be processed by extract().


function varargs($args) {


    $count = count($args);


    for ($i = 0; $i < $count; $i += 2) {


        $result[$args[$i]] = $args[$i + 1];


    }


    


    return $result;


}





// Example


function test(&$ref1, &$ref2) {


    // Default arguments go here.


    $foo = "oof";


    


    // Do some magic.


    extract(varargs(func_get_args()));





    echo nl2br("\n\$var1 = $var1");


    echo nl2br("\n\$var2 = $var2");


    echo nl2br("\n\$foo = $foo\n\n");


    


    // Modify some variables that were passed by reference.


    // Note that func_get_args() doesn't pass references, so they


    // need to be explicitly declared in the function definition.


    $ref1 = 42;


    $ref2 = 84;


}





$a = 5;


$b = 6;





echo nl2br("Before calling test(): \$a = $a\n");


echo nl2br("Before calling test(): \$b = $b\n");





// Try removing the 'foo, "bar"' from the following line.


test($a, $b, var1, "abc", var2, "def", foo, "bar");





echo nl2br("After calling test(): \$a = $a\n");


echo nl2br("After calling test(): \$b = $b\n");


?>

04-Jun-2001 07:44


You can pass a variable number of arguments to a function whilst keeping references intact by using an array. The disadvantage of course, is that the called function needs to be aware that it's arguments are in an array.


<?


// Prints "hello mutated world"


function mutator($args=null) {


$n=count($args);


while($i<$n) $args[$i++] = "mutated";


}


$a = "hello";


$b = "strange";


$c = "world";


mutator(array($a, &$b, $c));


echo "$a $b $c";


?>

add a note

MANUAL DE PHP

windsurf mercedes camper

func_get_args

DescripciÃ³n