<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.functions.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'functions.arrow.php',
    1 => 'Стрелочные функции',
    2 => 'Стрелочные функции',
  ),
  'up' => 
  array (
    0 => 'language.functions.php',
    1 => 'Функции',
  ),
  'prev' => 
  array (
    0 => 'functions.anonymous.php',
    1 => 'Анонимные функции',
  ),
  'next' => 
  array (
    0 => 'functions.first_class_callable_syntax.php',
    1 => 'Синтаксис создания первоклассных callable-значений',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'language/functions.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="functions.arrow" class="sect1">
  <h2 class="title">Стрелочные функции</h2>

  <p class="simpara">
   Стрелочные функции появились в PHP 7.4 как
   лаконичный синтаксис для <a href="functions.anonymous.php" class="link">анонимных функций</a>.
  </p>
  <p class="simpara">
   И анонимные, и стрелочные функции реализовали
   через класс <a href="class.closure.php" class="link"><span class="classname"><a href="class.closure.php" class="classname">Closure</a></span></a>.
  </p>

  <p class="simpara">
   Базовая форма записи стрелочных функций:
   <code class="code">fn (argument_list) =&gt; expr</code>.
  </p>

  <p class="simpara">
   Стрелочные функции работают так же,
   как <a href="functions.anonymous.php" class="link">анонимные функции</a>,
   за исключением того, что доступ к переменным
   родительской области стрелочные функции получают автоматически.
  </p>

  <p class="simpara">
   Когда стрелочная функция работает с переменной,
   которую определили в родительской области,
   переменная неявно захватывается по значению.
   В следующем примере функции <var class="varname">$fn1</var>
   и <var class="varname">$fn2</var> ведут себя одинаково.
  </p>

  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Пример #1 
     Стрелочные функции захватывают переменные по значению автоматически
    </strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$y </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$fn1 </span><span style="color: #007700">= fn(</span><span style="color: #0000BB">$x</span><span style="color: #007700">) =&gt; </span><span style="color: #0000BB">$x </span><span style="color: #007700">+ </span><span style="color: #0000BB">$y</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// Эквивалентно получению переменной $y по значению:<br /></span><span style="color: #0000BB">$fn2 </span><span style="color: #007700">= function (</span><span style="color: #0000BB">$x</span><span style="color: #007700">) use (</span><span style="color: #0000BB">$y</span><span style="color: #007700">) {<br />    return </span><span style="color: #0000BB">$x </span><span style="color: #007700">+ </span><span style="color: #0000BB">$y</span><span style="color: #007700">;<br />};<br /><br /></span><span style="color: #0000BB">var_export</span><span style="color: #007700">(</span><span style="color: #0000BB">$fn1</span><span style="color: #007700">(</span><span style="color: #0000BB">3</span><span style="color: #007700">));</span></span></code></div>
    </div>

    
<div class="example-contents"><p>
 Результат выполнения приведённого примера:
</p></div>

    <div class="example-contents screen">
<div class="cdata"><pre>
4
</pre></div>
    </div>
   </div>
  </p>
  <p class="simpara">
   Это также работает во вложенных стрелочных функциях:
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <p><strong>Пример #2 
     Стрелочные функции захватывают переменные по значению автоматически,
     даже когда функции вложены
    </strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$z </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$fn </span><span style="color: #007700">= fn(</span><span style="color: #0000BB">$x</span><span style="color: #007700">) =&gt; fn(</span><span style="color: #0000BB">$y</span><span style="color: #007700">) =&gt; </span><span style="color: #0000BB">$x </span><span style="color: #007700">* </span><span style="color: #0000BB">$y </span><span style="color: #007700">+ </span><span style="color: #0000BB">$z</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// Выведет 51<br /></span><span style="color: #0000BB">var_export</span><span style="color: #007700">(</span><span style="color: #0000BB">$fn</span><span style="color: #007700">(</span><span style="color: #0000BB">5</span><span style="color: #007700">)(</span><span style="color: #0000BB">10</span><span style="color: #007700">));</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="simpara">
   Как и в анонимных функциях,
   синтаксис стрелочных функций допускает произвольные сигнатуры функций,
   включая типы параметров и возвращаемых значений, значения по умолчанию,
   переменные и передачу и возврат по ссылке.
   Корректные примеры стрелочных функций:
  </p>
  <p class="para">
   <div class="example" id="example-3">
    <p><strong>Пример #3 Примеры определения стрелочных функций</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">fn(array </span><span style="color: #0000BB">$x</span><span style="color: #007700">) =&gt; </span><span style="color: #0000BB">$x</span><span style="color: #007700">;<br />static fn(</span><span style="color: #0000BB">$x</span><span style="color: #007700">): </span><span style="color: #0000BB">int </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">$x</span><span style="color: #007700">;<br />fn(</span><span style="color: #0000BB">$x </span><span style="color: #007700">= </span><span style="color: #0000BB">42</span><span style="color: #007700">) =&gt; </span><span style="color: #0000BB">$x</span><span style="color: #007700">;<br />fn(&amp;</span><span style="color: #0000BB">$x</span><span style="color: #007700">) =&gt; </span><span style="color: #0000BB">$x</span><span style="color: #007700">;<br />fn&amp;(</span><span style="color: #0000BB">$x</span><span style="color: #007700">) =&gt; </span><span style="color: #0000BB">$x</span><span style="color: #007700">;<br />fn(</span><span style="color: #0000BB">$x</span><span style="color: #007700">, ...</span><span style="color: #0000BB">$rest</span><span style="color: #007700">) =&gt; </span><span style="color: #0000BB">$rest</span><span style="color: #007700">;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="simpara">
   Стрелочные функции привязывают переменные по значению.
   Это примерно эквивалентно выполнению конструкции <code class="code">use($x)</code>
   для каждой переменной <var class="varname">$x</var>, с которой стрелочная функция
   будет работать внутри.
   Привязка по значению означает, что внутри стрелочной функции невозможно
   изменить значения из внешней области видимости.
   Вместо этого для привязок по ссылкам можно пользоваться
   <a href="functions.anonymous.php" class="link">анонимными функциями</a>.
  </p>
  <p class="para">
   <div class="example" id="example-4">
    <p><strong>Пример #4 
     Стрелочные функции не умеют изменять значения из внешней области видимости
    </strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$x </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$fn </span><span style="color: #007700">= fn() =&gt; </span><span style="color: #0000BB">$x</span><span style="color: #007700">++; </span><span style="color: #FF8000">// Функция ничего не изменит<br /></span><span style="color: #0000BB">$fn</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">var_export</span><span style="color: #007700">(</span><span style="color: #0000BB">$x</span><span style="color: #007700">);     </span><span style="color: #FF8000">// Функция выведет значение 1</span></span></code></div>
    </div>

   </div>
  </p>

  <div class="sect2">
   <h3 class="title">Список изменений</h3>
   <p class="para">
    <table class="doctable informaltable">
     
      <thead>
       <tr>
        <th>Версия</th>
        <th>Описание</th>
       </tr>

      </thead>

      <tbody class="tbody">
       <tr>
        <td>7.4.0</td>
        <td>
         Появились стрелочные функции.
        </td>
       </tr>

      </tbody>
     
    </table>

   </p>
  </div>

  <div class="sect2">
   <h3 class="title">Примечания</h3>
   <blockquote class="note"><p><strong class="note">Замечание</strong>: 
    <span class="simpara">
     Из стрелочной функции разрешается вызывать функции
     <span class="function"><a href="function.func-num-args.php" class="function">func_num_args()</a></span>, <span class="function"><a href="function.func-get-arg.php" class="function">func_get_arg()</a></span>
     и <span class="function"><a href="function.func-get-args.php" class="function">func_get_args()</a></span>.
    </span>
   </p></blockquote>
  </div>
 </div><?php manual_footer($setup); ?>