<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.ev.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'ev.watcher-callbacks.php',
    1 => 'Las funciones de retrollamada de un Watcher',
    2 => 'Las funciones de retrollamada de un Watcher',
  ),
  'up' => 
  array (
    0 => 'book.ev.php',
    1 => 'Ev',
  ),
  'prev' => 
  array (
    0 => 'ev.watchers.php',
    1 => 'Watchers',
  ),
  'next' => 
  array (
    0 => 'ev.periodic-modes.php',
    1 => 'Modos de operaci&oacute;n peri&oacute;dica de un watcher',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/ev/watcher-callbacks.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ev.watcher-callbacks" class="chapter">
 <h1 class="title">Las funciones de retrollamada de un Watcher</h1>

 <p class="simpara">
  Todos los watchers pueden estar activos (esperando eventos) o inactivos
  (en pausa). Solo los watchers activos pueden tener sus funciones de retrollamada
  llamadas. Todas las funciones de retrollamada serán llamadas con al menos dos
  argumentos:
  <code class="parameter">watcher</code> - el watcher, y <code class="parameter">revents</code>,
  una máscara de eventos recibidos.
 </p>
 <p class="simpara">
  Las funciones de retrollamada de los watchers son pasadas a los constructores de los watchers
  (una clase derivada de <span class="classname"><a href="class.evwatcher.php" class="classname">EvWatcher</a></span> -
  <span class="methodname"><a href="evcheck.construct.php" class="methodname">EvCheck::__construct()</a></span>, <span class="methodname"><a href="evchild.construct.php" class="methodname">EvChild::__construct()</a></span>
  etc.). Una función de retrollamada de un watcher debe coincidir con el siguiente prototipo:
 </p>
 <div class="methodsynopsis dc-description"><span class="methodname"><strong>callback</strong></span>(<span class="methodparam">
   
   <span class="type"><a href="language.types.object.php" class="type object">object</a></span> <code class="parameter">$watcher</code>
   <span class="initializer"> = NULL</span>
  </span>, <span class="methodparam">
   
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$revents</code>
   <span class="initializer"> = NULL</span>
  </span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>

 <dl>
  
   <dt>
    <code class="parameter">watcher</code>
   </dt>
   <dd>
    <span class="simpara">
     La instancia del watcher (de una clase que extiende <span class="classname"><a href="class.evwatcher.php" class="classname">EvWatcher</a></span>).
    </span>
   </dd>
  
  
   <dt>
    <code class="parameter">revents</code>
   </dt>
   <dd>
    <span class="simpara">
     <a href="class.ev.php#ev.constants.watcher-revents" class="link">Un watcher que recibe los eventos</a>.
    </span>
   </dd>
  
 </dl>
 <p class="simpara">
  Cada tipo de watcher tiene un byte asociado en
  <code class="parameter">revents</code>, por lo tanto, se puede utilizar la misma
  función de retrollamada para varios watchers. La máscara de eventos
  se nombra según el tipo, es decir,
  <span class="classname"><a href="class.evchild.php" class="classname">EvChild</a></span> (o <span class="methodname"><a href="evloop.child.php" class="methodname">EvLoop::child()</a></span>) define
  <strong><code><a href="class.ev.php#ev.constants.child">EV::CHILD</a></code></strong>, <span class="classname"><a href="class.evprepare.php" class="classname">EvPrepare</a></span> (o
  <span class="methodname"><a href="evloop.prepare.php" class="methodname">EvLoop::prepare()</a></span>) define <strong><code><a href="class.ev.php#ev.constants.prepare">Ev::PREPARE</a></code></strong>,
  <span class="classname"><a href="class.evperiodic.php" class="classname">EvPeriodic</a></span> (o <span class="methodname"><a href="evloop.periodic.php" class="methodname">EvLoop::periodic()</a></span>)
  define <strong><code><a href="class.ev.php#ev.constants.periodic">Ev::PERIODIC</a></code></strong> y así sucesivamente, con la excepción de los
  eventos de E/S (que pueden definir tanto los bytes
  <strong><code><a href="class.ev.php#ev.constants.read">Ev::READ</a></code></strong> como <strong><code><a href="class.ev.php#ev.constants.write">Ev::WRITE</a></code></strong>).
 </p>
</div>
<?php manual_footer($setup); ?>