Какова цель & перед именем функции?

Question

Я знаю, что & используется для ссылок, и я видел раньше, как:

$foo = &$bar; 

или

function foo(&$bar) {...} 

или

foreach($array as &$value) {...} 

И я знаю, что & означает в вышеуказанных ситуациях ,

---

Но я видел эту функцию в CodeIgniter:

function &get_instance() { 
    return CI_Controller::get_instance(); 
} 

Я никогда не видел & перед именем функции прежде. Что делает & сделать в вышеуказанной функции?

Answer 1

Это называется returning by reference, оно просто ограничивает возвращаемое значение переменной, к которой вы ее назначили. В руководстве есть наглядный пример:

<?php 

    class foo { 
     public $value = 42; 

     public function &getValue() { 
      return $this->value; 
     } 
    } 

    $obj = new foo(); 
    $myValue = &$obj->getValue(); // $myValue is a reference to $obj->value, which is 42. 
    $obj->value = 2; 
    echo $myValue;    // prints the new value of $obj->value, i.e. 2. 

?>