<?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 => 'es',
  ),
  'this' => 
  array (
    0 => 'functions.first_class_callable_syntax.php',
    1 => 'Sintaxis callable de primera clase',
    2 => 'Sintaxis callable de primera clase',
  ),
  'up' => 
  array (
    0 => 'language.functions.php',
    1 => 'Las funciones',
  ),
  'prev' => 
  array (
    0 => 'functions.arrow.php',
    1 => 'Funci&oacute;n Flecha',
  ),
  'next' => 
  array (
    0 => 'language.oop5.php',
    1 => 'Clases y objetos',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    '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.first_class_callable_syntax" class="sect1">
  <h2 class="title">Sintaxis callable de primera clase</h2>

  <p class="para">
   La sintaxis de callable de primera clase se introduce a partir de PHP 8.1.0,
   como una manera de crear <a href="functions.anonymous.php" class="link">funciones anónimas</a>
   desde <a href="language.types.callable.php" class="link">callables</a>.
   Reemplaza la sintaxis de callables existente que utiliza cadenas y arrays.
   La ventaja de esta sintaxis es que es accesible al análisis estático
   y utiliza el ámbito del punto donde el callable es adquirido.
  </p>

  <p class="para">
   La sintaxis <code class="code">CallableExpr(...)</code> se utiliza para crear un objeto
   <span class="classname"><a href="class.closure.php" class="classname">Closure</a></span> desde el callable.
   <code class="code">CallableExpr</code> acepta cualquier expresión que pueda ser directamente
   llamada en la gramática de PHP:
   <div class="example" id="example-1">
    <p><strong>Ejemplo #1 Sintaxis callable de primera clase básica</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo </span><span style="color: #007700">{<br />   public function </span><span style="color: #0000BB">method</span><span style="color: #007700">() {}<br />   public static function </span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">() {}<br />   public function </span><span style="color: #0000BB">__invoke</span><span style="color: #007700">() {}<br />}<br /></span><span style="color: #0000BB">$obj </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$classStr </span><span style="color: #007700">= </span><span style="color: #DD0000">'Foo'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$methodStr </span><span style="color: #007700">= </span><span style="color: #DD0000">'method'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$staticmethodStr </span><span style="color: #007700">= </span><span style="color: #DD0000">'staticmethod'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$f1 </span><span style="color: #007700">= </span><span style="color: #0000BB">strlen</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f2 </span><span style="color: #007700">= </span><span style="color: #0000BB">$obj</span><span style="color: #007700">(...);  </span><span style="color: #FF8000">// objeto invocable<br /></span><span style="color: #0000BB">$f3 </span><span style="color: #007700">= </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">method</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f4 </span><span style="color: #007700">= </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">$methodStr</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f5 </span><span style="color: #007700">= </span><span style="color: #0000BB">Foo</span><span style="color: #007700">::</span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f6 </span><span style="color: #007700">= </span><span style="color: #0000BB">$classStr</span><span style="color: #007700">::</span><span style="color: #0000BB">$staticmethodStr</span><span style="color: #007700">(...);<br /></span><span style="color: #FF8000">// callable tradicional usando string, array<br /></span><span style="color: #0000BB">$f7 </span><span style="color: #007700">= </span><span style="color: #DD0000">'strlen'</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f8 </span><span style="color: #007700">= [</span><span style="color: #0000BB">$obj</span><span style="color: #007700">, </span><span style="color: #DD0000">'method'</span><span style="color: #007700">](...);<br /></span><span style="color: #0000BB">$f9 </span><span style="color: #007700">= [</span><span style="color: #0000BB">Foo</span><span style="color: #007700">::class, </span><span style="color: #DD0000">'staticmethod'</span><span style="color: #007700">](...);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>

  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    Los <code class="code">...</code> forman parte de la sintaxis y no son una omisión.
   </p>
  </p></blockquote>

  <p class="para">
   <code class="code">CallableExpr(...)</code> tiene las mismas semánticas que <span class="methodname"><a href="closure.fromcallable.php" class="methodname">Closure::fromCallable()</a></span>.
   Es decir, a diferencia de los callables que utilizan cadenas y arrays,
   <code class="code">CallableExpr(...)</code> respeta el ámbito del punto donde es creado:
   <div class="example" id="example-2">
    <p><strong>Ejemplo #2 Comparación de ámbito de <code class="code">CallableExpr(...)</code> y callables tradicionales</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo </span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">() {<br />        return [</span><span style="color: #0000BB">$this</span><span style="color: #007700">, </span><span style="color: #DD0000">'privateMethod'</span><span style="color: #007700">];<br />    }<br />    private function </span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">() {<br />        echo </span><span style="color: #0000BB">__METHOD__</span><span style="color: #007700">, </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /></span><span style="color: #0000BB">$foo </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$privateMethod </span><span style="color: #007700">= </span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$privateMethod</span><span style="color: #007700">();<br /></span><span style="color: #FF8000">// Fatal error: Call to private method Foo::privateMethod() from global scope<br />// Esto es porque la llamada se realiza fuera de Foo y la visibilidad será verificada desde este punto.<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo1 </span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">() {<br />        </span><span style="color: #FF8000">// Usa el ámbito donde el callable es adquirido.<br />        </span><span style="color: #007700">return </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">(...); </span><span style="color: #FF8000">// idéntico a Closure::fromCallable([$this, 'privateMethod']);<br />    </span><span style="color: #007700">}<br />    private function </span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">() {<br />        echo </span><span style="color: #0000BB">__METHOD__</span><span style="color: #007700">, </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /></span><span style="color: #0000BB">$foo1 </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$privateMethod </span><span style="color: #007700">= </span><span style="color: #0000BB">$foo1</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$privateMethod</span><span style="color: #007700">();  </span><span style="color: #FF8000">// Foo1::privateMethod<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

  </p>

  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    La creación de objetos con esta sintaxis (por ejemplo <code class="code">new Foo(...)</code>) no es soportada,
    ya que la sintaxis <code class="code">new Foo()</code> no es considerada una llamada.
   </p>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    La sintaxis de callable de primera clase no puede ser combinada con
    el <a href="language.oop5.basic.php#language.oop5.basic.nullsafe" class="link">operador nullsafe</a>.
    Los dos casos siguientes resultan en un error de compilación:
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$obj</span><span style="color: #007700">?-&gt;</span><span style="color: #0000BB">method</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$obj</span><span style="color: #007700">?-&gt;</span><span style="color: #0000BB">prop</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">method</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </p></blockquote>
 </div><?php manual_footer($setup); ?>