<?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 => 'fr',
  ),
  'this' => 
  array (
    0 => 'ev.watcher-callbacks.php',
    1 => 'Les fonctions de rappel d\'un Watcher',
    2 => 'Les fonctions de rappel d\'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 => 'Modes d\'op&eacute;ration p&eacute;riodique d\'un watcher',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    '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">Les fonctions de rappel d&#039;un Watcher</h1>

 <p class="simpara">
  Tous les watchers peuvent être actifs (en attente d&#039;événements) ou inactifs
  (en pause). Seuls les watchers actifs peuvent avoir leurs fonctions de rappel
  d&#039;appelées. Toutes les fonctions de rappel seront appelées avec au moins deux
  arguments :
  <code class="parameter">watcher</code> - le watcher, et <code class="parameter">revents</code>,
  un masque d&#039;événements reçus.
 </p>
 <p class="simpara">
  Les fonctions de rappel des watchers sont passées aux constructeurs des watchers
  (une classe dérivée 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.). Une fonction de rappel d&#039;un watcher doit correspondre au prototype suivant :
 </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">
     L&#039;instance du watcher (d&#039;une classe étendant <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 recevant les événements</a>.
    </span>
   </dd>
  
 </dl>
 <p class="simpara">
  Chaque type de watcher a un octet d&#039;associé dans
  <code class="parameter">revents</code>, aussi, on peut utiliser la même
  fonction de rappel pour plusieurs watchers. Le masque d&#039;événements
  est nommé après le type, c.-à-d.
  <span class="classname"><a href="class.evchild.php" class="classname">EvChild</a></span> (ou <span class="methodname"><a href="evloop.child.php" class="methodname">EvLoop::child()</a></span>) définit
  <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> (ou
  <span class="methodname"><a href="evloop.prepare.php" class="methodname">EvLoop::prepare()</a></span>) définit <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> (ou <span class="methodname"><a href="evloop.periodic.php" class="methodname">EvLoop::periodic()</a></span>)
  définit <strong><code><a href="class.ev.php#ev.constants.periodic">Ev::PERIODIC</a></code></strong> et ainsi de suite, avec comme exception les
  événements I/O (qui peuvent définir à la fois les octets
  <strong><code><a href="class.ev.php#ev.constants.read">Ev::READ</a></code></strong> et <strong><code><a href="class.ev.php#ev.constants.write">Ev::WRITE</a></code></strong>).
 </p>
</div>
<?php manual_footer($setup); ?>