CALL_USER_FUNC(3)							 1							 CALL_USER_FUNC(3)

call_user_func - Call the callback given by the first parameter

SYNOPSIS

       mixed call_user_func (callable  $callback, [mixed  $parameter], [mixed  $...])

DESCRIPTION

	Calls the $callback given by the first parameter and passes the remaining parameters as arguments.

PARAMETERS

	      o $callback
		- The callable to be called.

	      o $parameter
		- Zero or more parameters to be passed to the callback.

	      Note

		      Note that the parameters for call_user_func(3) are not passed by reference.

		     Example #1

			    call_user_func(3) example and references

			    <?php
			    error_reporting(E_ALL);
			    function increment(&$var)
			    {
				$var++;
			    }

			    $a = 0;
			    call_user_func('increment', $a);
			    echo $a."
";

			    // You can use this instead
			    call_user_func_array('increment', array(&$a));
			    echo $a."
";
			    ?>

			    The above example will output:

			    0
			    1

RETURN VALUES

	Returns the return value of the callback, or FALSE on error.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  The	interpretation	of object oriented keywords |
       |	| like parent and  self  has  changed.	Previously, |
       |	| calling  them using the double colon syntax would |
       |	| emit an E_STRICT warning because they were inter- |
       |	| preted as static.				    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #2

	      call_user_func(3) example

	      <?php
	      function barber($type)
	      {
		  echo "You wanted a $type haircut, no problem
";
	      }
	      call_user_func('barber', "mushroom");
	      call_user_func('barber', "shave");
	      ?>

	      The above example will output:

	      You wanted a mushroom haircut, no problem
	      You wanted a shave haircut, no problem

       Example #3

	      call_user_func(3) using namespace name

	      <?php

	      namespace Foobar;

	      class Foo {
		  static public function test() {
		      print "Hello world!
";
		  }
	      }

	      call_user_func(__NAMESPACE__ .'Foo::test'); // As of PHP 5.3.0
	      call_user_func(array(__NAMESPACE__ .'Foo', 'test')); // As of PHP 5.3.0

	      ?>

	      The above example will output:

	      Hello world!
	      Hello world!

       Example #4

	      Using a class method with call_user_func(3)

	      <?php

	      class myclass {
		  static function say_hello()
		  {
		      echo "Hello!
";
		  }
	      }

	      $classname = "myclass";

	      call_user_func(array($classname, 'say_hello'));
	      call_user_func($classname .'::say_hello'); // As of 5.2.3

	      $myobject = new myclass();

	      call_user_func(array($myobject, 'say_hello'));

	      ?>

	      The above example will output:

	      Hello!
	      Hello!
	      Hello!

       Example #5

	      Using lambda function with call_user_func(3)

	      <?php
	      call_user_func(function($arg) { print "[$arg]
"; }, 'test'); /* As of PHP 5.3.0 */
	      ?>

	      The above example will output:

	      [test]

NOTES

       Note

	      Callbacks registered with functions such as call_user_func(3) and call_user_func_array(3) will not be called if there is an uncaught
	      exception thrown in a previous callback.

SEE ALSO

       call_user_func_array(3), is_callable(3), information about the callback type, ReflectionFunction::invoke, ReflectionMethod::invoke.

PHP Documentation Group 													 CALL_USER_FUNC(3)