<?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 => 'de',
  ),
  'this' => 
  array (
    0 => 'functions.arrow.php',
    1 => 'Pfeilfunktionen',
    2 => 'Pfeilfunktionen',
  ),
  'up' => 
  array (
    0 => 'language.functions.php',
    1 => 'Funktionen',
  ),
  'prev' => 
  array (
    0 => 'functions.anonymous.php',
    1 => 'Anonyme Funktionen',
  ),
  'next' => 
  array (
    0 => 'functions.first_class_callable_syntax.php',
    1 => 'Callback-Funktionen als Objekte erster Klasse',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    '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">Pfeilfunktionen</h2>
   <p class="simpara">
    Pfeilfunktionen wurden in PHP 7.4 als prägnantere Syntax für
    <a href="functions.anonymous.php" class="link">anonyme Funktionen</a> eingeführt.
   </p>
   <p class="simpara">
    Sowohl anonyme Funktionen als auch Pfeilfunktionen sind unter Verwendung der
    <a href="class.closure.php" class="link"><span class="classname"><a href="class.closure.php" class="classname">Closure</a></span></a>-Klasse
    implementiert.
   </p>
   <p class="simpara">
    Pfeilfunktionen haben die grundsätzliche Form
    <code class="code">fn (argument_list) =&gt; expr</code>.
   </p>
   <p class="simpara">
    Pfeilfunktionen unterstützen dieselbe Funktionalität wie
    <a href="functions.anonymous.php" class="link">anonyme Funktionen</a>,
    außer, dass die Verwendung von Variablen des Eltern-Gültigkeitsbereichs
    immer automatisch erfolgt.
   </p>
   <p class="simpara">
    Wenn eine Variable, die im Ausdruck verwendet wird, im
    Eltern-Gültigkeitsbereich definiert ist, wird sie implizit per Wertübergabe
    gebunden. Im folgenden Beispiel verhalten sich die Funktionen
    <var class="varname">$fn1</var> und <var class="varname">$fn2</var> auf die gleiche Weise.
   </p>
   <p class="para">
    <div class="example" id="example-1">
     <p><strong>Beispiel #1 Pfeilfunktionen binden Variablen automatisch per Wertübergabe</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">// gleichwertig zur Verwendung von $y per Wertübergabe:<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>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</p></div>
     <div class="example-contents screen">
<div class="cdata"><pre>
4
</pre></div>
      </div>
    </div>
   </p>
   <p class="simpara">
    Dies funktioniert auch, wenn Pfeilfunktionen verschachtelt werden:
   </p>
   <p class="para">
    <div class="example" id="example-2">
     <p><strong>Beispiel #2 Pfeilfunktionen binden Variablen automatisch per Wertübergabe, selbst wenn sie verschachtelt sind</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">// gibt 51 aus<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">
    Ähnlich wie bei anonymen Funktion erlaubt die Pfeilfunktionssyntax
    beliebige Funktionssignaturen, einschließlich Parameter- und
    Rückgabetypen, Defaultwerte, variadische Parameter sowie Referenzübergabe
    und -rückgabe. Alle folgenden sind gültige Beispiele von Pfeilfunktionen:
   </p>
   <p class="para">
    <div class="example" id="example-3">
     <p><strong>Beispiel #3 Beispiele von Pfeilfunktionen</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">
    Pfeilfunktionen verwenden die Wertübergabe-Bindung. Dies entspricht in
    etwa der Verwendung von <code class="code">use($x)</code> für jede Variable
    <var class="varname">$x</var>, die in der Pfeilfunktion verwendet wird.
    Wertübergabe-Bindung bedeutet, dass es nicht möglich ist, Werte aus dem
    äußeren Geltungsbereich zu ändern.
    <a href="functions.anonymous.php" class="link">Anonyme Funktionen</a> können statt
    dessen für Referenzübergabe-Bindungen verwendet werden.
   </p>
   <p class="para">
    <div class="example" id="example-4">
     <p><strong>Beispiel #4 Werte aus dem äußeren Geltungsbereich können nicht durch Pfeilfunktionen geändert werden</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">// hat keine Wirkung<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">// gibt 1 aus<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>

   <div class="sect2">
    <h3 class="title">Changelog</h3>
    <p class="para">
     <table class="doctable informaltable">
      
       <thead>
        <tr>
         <th>Version</th>
         <th>Beschreibung</th>
        </tr>

       </thead>

       <tbody class="tbody">
        <tr>
         <td>7.4.0</td>
         <td>
          Pfeilfunktionen sind verfügbar.
         </td>
        </tr>

       </tbody>
      
     </table>

    </p>
   </div>

   <div class="sect2">
    <h3 class="title">Anmerkungen</h3>
    <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
     <span class="simpara">
      Es ist möglich <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> und <span class="function"><a href="function.func-get-args.php" class="function">func_get_args()</a></span>
      innerhalb einer Pfeilfunktion zu verwenden.
     </span>
    </p></blockquote>
   </div>
  </div><?php manual_footer($setup); ?>