<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'class.evprepare.php',
    1 => 'EvPrepare',
    2 => 'A classe EvPrepare',
  ),
  'up' => 
  array (
    0 => 'book.ev.php',
    1 => 'Ev',
  ),
  'prev' => 
  array (
    0 => 'evperiodic.set.php',
    1 => 'EvPeriodic::set',
  ),
  'next' => 
  array (
    0 => 'evprepare.construct.php',
    1 => 'EvPrepare::__construct',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/ev/evprepare.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.evprepare.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.evprepare" class="reference">
 <h1 class="title">A classe EvPrepare</h1>
 
 <div class="partintro"><p class="verinfo">(PECL ev &gt;= 0.2.0)</p>

  <div class="section" id="evprepare.intro">
   <h2 class="title">Introdução</h2><p class="simpara">
    Os observadores <span class="classname"><strong class="classname">EvPrepare</strong></span>
    e
    <span class="classname"><a href="class.evcheck.php" class="classname">EvCheck</a></span>
    são geralmente usados em pares.
    Os observadores <span class="classname"><strong class="classname">EvPrepare</strong></span>
    são invocados antes do bloqueio do processo,
    <span class="classname"><a href="class.evcheck.php" class="classname">EvCheck</a></span>
    depois.
   </p><p class="simpara">
    Não é permitido chamar
    <span class="methodname"><a href="evloop.run.php" class="methodname">EvLoop::run()</a></span>
    ou métodos ou funções similares que entrem no laço de eventos atual dos
    observadores
    <span class="classname"><strong class="classname">EvPrepare</strong></span>
    ou
    <span class="classname"><a href="class.evcheck.php" class="classname">EvCheck</a></span>.
    Outros laços além do atual são adequados, entretanto. A
    lógica por trás disso é que não é necessário verificar a recursão
    nesses observadores, ou seja, a sequência será sempre:
   <span class="classname"><strong class="classname">EvPrepare</strong></span>
   -&gt; bloqueando -&gt;
   <span class="classname"><a href="class.evcheck.php" class="classname">EvCheck</a></span>,
   portanto, tendo um observador de cada tipo, eles sempre serão chamados em pares,
   colocando entre colchetes a chamada de bloqueio.
   </p><p class="simpara">
    O objetivo principal é integrar outros mecanismos de eventos no
    <em>libev</em>
    e seu uso está um tanto avançado. Eles poderiam ser usados, por exemplo, para
    rastrear alterações de variáveis, implementar observadores personalizados, integrar net-snmp ou uma
    biblioteca de corrotinas e muito mais. Ocasionalmente, eles também são úteis para
    armazenar alguns dados em cache e deseja liberá-los antes de bloqueá-los.
   </p><p class="simpara">
    É recomendado dar aos observadores
    <span class="classname"><a href="class.evcheck.php" class="classname">EvCheck</a></span>
    a prioridade mais alta (
     <strong><code><a href="class.ev.php#ev.constants.maxpri">Ev::MAXPRI</a></code></strong>),
     para garantir que eles estejam sendo executados antes de qualquer outro observador
     após o poll (isso não importa para
     observadores
     <span class="classname"><strong class="classname">EvPrepare</strong></span>).
   </p><p class="simpara">
    Além disso,
    os observadores do <span class="classname"><a href="class.evcheck.php" class="classname">EvCheck</a></span>
    não devem ativar/alimentar eventos. Embora
    <em>libev</em>
    suporte totalmente isso, eles podem ser executados antes que outros
    observadores <span class="classname"><a href="class.evcheck.php" class="classname">EvCheck</a></span>
    façam seu trabalho.
   </p>
  </div>

  <div class="section" id="evprepare.synopsis">
   <h2 class="title">Resumo da classe</h2>


   <div class="classsynopsis">
    <span class="ooclass">
     <strong class="classname"></strong>
    </span>

    <div class="classsynopsisinfo">
     <span class="ooclass">
      <span class="modifier">class</span> <strong class="classname">EvPrepare</strong>
     </span>
     <span class="ooclass">
      <span class="modifier">extends</span>
       <a href="class.evwatcher.php" class="classname">EvWatcher</a>
     </span>
     {</div>


    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Propriedades herdadas */</div>
    <div class="fieldsynopsis">
     <span class="modifier">public</span>
      <var class="varname"><a href="class.evwatcher.php#evwatcher.props.is-active">$<var class="varname">is_active</var></a></var>;</div>
<div class="fieldsynopsis"><span class="modifier">public</span>
      <var class="varname"><a href="class.evwatcher.php#evwatcher.props.data">$<var class="varname">data</var></a></var>;</div>
<div class="fieldsynopsis"><span class="modifier">public</span>
      <var class="varname"><a href="class.evwatcher.php#evwatcher.props.is-pending">$<var class="varname">is_pending</var></a></var>;</div>
<div class="fieldsynopsis"><span class="modifier">public</span>
      <var class="varname"><a href="class.evwatcher.php#evwatcher.props.priority">$<var class="varname">priority</var></a></var>;</div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Métodos */</div>
    <div class="constructorsynopsis dc-description">
   <span class="modifier">public</span>
   <span class="methodname"><a href="evprepare.construct.php" class="methodname">__construct</a></span>(<span class="methodparam">
    
    <span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$callback</code>
   </span>, <span class="methodparam">
    
    <span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$data</code>
   <span class="initializer"> = ?</span></span>, <span class="methodparam">
    
    <span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$priority</code>
   <span class="initializer"> = ?</span></span>)</div>

    <div class="methodsynopsis dc-description"><span class="modifier">final</span>
   <span class="modifier">public</span>
   <span class="modifier">static</span>
   <span class="methodname"><a href="evprepare.createstopped.php" class="methodname">createStopped</a></span>(<span class="methodparam">
    
    <span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$callback</code>
   </span>, <span class="methodparam">
    
    <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$data</code>
    <span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span>
   </span>, <span class="methodparam">
    
    <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$priority</code>
    <span class="initializer"> = 0</span>
   </span>): <span class="type"><a href="class.evprepare.php" class="type EvPrepare">EvPrepare</a></span></div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Métodos herdados */</div>
    <div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.clear.php" class="methodname">EvWatcher::clear</a></span>(): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.feed.php" class="methodname">EvWatcher::feed</a></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>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.getloop.php" class="methodname">EvWatcher::getLoop</a></span>(): <span class="type"><a href="class.evloop.php" class="type EvLoop">EvLoop</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.invoke.php" class="methodname">EvWatcher::invoke</a></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>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.keepalive.php" class="methodname">EvWatcher::keepalive</a></span>(<span class="methodparam">
    
    <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$value</code>
   <span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.setcallback.php" class="methodname">EvWatcher::setCallback</a></span>(<span class="methodparam">
    
    <span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$callback</code>
   </span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.start.php" class="methodname">EvWatcher::start</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evwatcher.stop.php" class="methodname">EvWatcher::stop</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>

   }</div>

  </div>
 </div>

 










<h2>Índice</h2><ul class="chunklist chunklist_reference"><li><a href="evprepare.construct.php">EvPrepare::__construct</a> — Constr&oacute;i objeto observador EvPrepare</li><li><a href="evprepare.createstopped.php">EvPrepare::createStopped</a> — Cria uma inst&acirc;ncia parada do observador EvPrepare</li></ul>
</div>
<?php manual_footer($setup); ?>