<?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 => 'ja',
  ),
  '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' => 'ja',
    '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">
    アロー関数は <a href="functions.anonymous.php" class="link">無名関数</a>
    を簡潔に書ける文法として PHP 7.4 で追加されました。
   </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 /></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">));<br /></span><span style="color: #0000BB">?&gt;</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 /></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">));<br /></span><span style="color: #0000BB">?&gt;</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">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   <p class="simpara">
    アロー関数は変数を値でバインドします。
    これは変数 <var class="varname">$x</var> をアロー関数の内部で使うたびに
    <code class="code">use($x)</code> を実行することと大体同じです。
    値でバインドするということは、アロー関数の外のスコープの値を変更することが不可能だということです。
    参照でバインドしたい場合は、<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 を出力<br /><br /></span><span style="color: #0000BB">?&gt;</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); ?>