<?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 => 'class.evperiodic.php',
    1 => 'EvPeriodic',
    2 => 'La clase EvPeriodic',
  ),
  'up' => 
  array (
    0 => 'book.ev.php',
    1 => 'Ev',
  ),
  'prev' => 
  array (
    0 => 'evloop.verify.php',
    1 => 'EvLoop::verify',
  ),
  'next' => 
  array (
    0 => 'evperiodic.again.php',
    1 => 'EvPeriodic::again',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/ev/evperiodic.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.evperiodic.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.evperiodic" class="reference">
 <h1 class="title">La clase EvPeriodic</h1>
 
 <div class="partintro"><p class="verinfo">(PECL ev &gt;= 0.2.0)</p>

  <div class="section" id="evperiodic.intro">
   <h2 class="title">Introducción</h2>
  <p class="simpara">
   Los observadores periódicos son una especie de temporizadores, pero son muy
   versátiles.
   </p>
   <p class="simpara">
    A diferencia de <span class="classname"><a href="class.evtimer.php" class="classname">EvTimer</a></span>, los observadores
    <span class="classname"><strong class="classname">EvPeriodic</strong></span> no se basan en un tiempo real
    (o un tiempo relativo, el tiempo físico que transcurre), sino en un tiempo
    de reloj (tiempo absoluto, calendario o de reloj). La diferencia es
    que un tiempo de reloj puede ser más rápido o más lento que un tiempo
    real, y los saltos en el tiempo no son raros (por ejemplo, durante un ajuste).
   </p>
   <p class="simpara">
    Un observador <span class="classname"><strong class="classname">EvPeriodic</strong></span> puede ser configurado para
    ser lanzado después de puntos específicos en el tiempo. Por ejemplo,
    si un observador <span class="classname"><strong class="classname">EvPeriodic</strong></span> está configurado para
    lanzarse <em>&quot;en 10 segundos&quot;</em> (es decir,
    <span class="methodname"><a href="evloop.now.php" class="methodname">EvLoop::now()</a></span> + <code class="literal">10.0</code>,
    es decir, un tiempo absoluto, y no un retraso), y el reloj del sistema
    se reinicia a <em>enero del año pasado</em>,
    entonces tomará un año o más para lanzar el evento (a diferencia
    de <span class="classname"><a href="class.evtimer.php" class="classname">EvTimer</a></span> que se lanzará <code class="literal">10</code>
    segundos después de su inicio, ya que utiliza un retraso máximo relativo).
   </p>
   <p class="simpara">
    Al igual que con los temporizadores, se garantiza que la función de retrollamada sea
    llamada únicamente cuando el punto en el tiempo en el que se supone que debe lanzarse
    haya pasado. Si varios temporizadores se vuelven listos al mismo tiempo
    durante la misma iteración del bucle, entonces aquellos con valores de retraso
    máximo más cercanos serán llamados antes que aquellos con valores de retraso
    máximo más lejanos (pero esto ya no es cierto cuando una función de retrollamada
    llama recursivamente al método <span class="methodname"><a href="evloop.run.php" class="methodname">EvLoop::run()</a></span>).
   </p>
  </div>

  <div class="section" id="evperiodic.synopsis">
   <h2 class="title">Sinopsis de la Clase</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">EvPeriodic</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">/* Propiedades */</div>
    <div class="fieldsynopsis">
     <span class="modifier">public</span>
      <var class="varname"><a href="class.evperiodic.php#evperiodic.props.offset">$<var class="varname">offset</var></a></var>;</div>

    <div class="fieldsynopsis"><span class="modifier">public</span>
      <var class="varname"><a href="class.evperiodic.php#evperiodic.props.interval">$<var class="varname">interval</var></a></var>;</div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Propiedades heredadas */</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="evperiodic.construct.php" class="methodname">__construct</a></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.float.php" class="type float">float</a></span> <code class="parameter">$offset</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$interval</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$reschedule_cb</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$callback</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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><br>)</div>

    <div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evperiodic.again.php" class="methodname">again</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="evperiodic.at.php" class="methodname">at</a></span>(): <span class="type"><a href="language.types.float.php" class="type float">float</a></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="evperiodic.createstopped.php" class="methodname">createStopped</a></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.float.php" class="type float">float</a></span> <code class="parameter">$offset</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.float.php" class="type float">float</a></span> <code class="parameter">$interval</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$reschedule_cb</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam">
    
    <span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$callback</code>
   </span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<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><br>): <span class="type"><a href="class.evperiodic.php" class="type EvPeriodic">EvPeriodic</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span>
   <span class="methodname"><a href="evperiodic.set.php" class="methodname">set</a></span>(<span class="methodparam">
    
    <span class="type"><a href="language.types.float.php" class="type float">float</a></span> <code class="parameter">$offset</code>
   </span>, <span class="methodparam">
    
    <span class="type"><a href="language.types.float.php" class="type float">float</a></span> <code class="parameter">$interval</code>
   </span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Métodos heredados */</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 class="section" id="evperiodic.props">
   <h2 class="title">Propiedades</h2>
   <dl>
    
     <dt id="evperiodic.props.offset">
      <var class="varname">offset</var>
     </dt>
     <dd>
      <span class="simpara">
       Al repetirse, contendrá el valor de la posición, de lo contrario,
       será el punto absoluto en el tiempo (el valor de la posición
       pasado al método <span class="methodname"><a href="evperiodic.set.php" class="methodname">EvPeriodic::set()</a></span>,
       aunque <em>libev</em> puede modificar este valor
       para una mejor estabilidad numérica).
      </span>
     </dd>
    
    
     <dt id="evperiodic.props.interval">
      <var class="varname">interval</var>
     </dt>
     <dd>
      <span class="simpara">
       El valor del intervalo actual. Puede ser modificado en cualquier momento,
       pero los cambios no surten efecto hasta que el temporizador
       periódico no se lance, o cuando se llame al método
       <span class="methodname"><a href="evperiodic.again.php" class="methodname">EvPeriodic::again()</a></span>.
      </span>
     </dd>
    
   </dl>
  </div>

 </div>

 































<h2>Tabla de contenidos</h2><ul class="chunklist chunklist_reference"><li><a href="evperiodic.again.php">EvPeriodic::again</a> — Detiene y reinicia el observador peri&oacute;dico</li><li><a href="evperiodic.at.php">EvPeriodic::at</a> — Devuelve el tiempo absoluto en el que este watcher ser&aacute; llamado la pr&oacute;xima vez</li><li><a href="evperiodic.construct.php">EvPeriodic::__construct</a> — Construye un objeto watcher EvPeriodic</li><li><a href="evperiodic.createstopped.php">EvPeriodic::createStopped</a> — Crea un watcher EvPeriodic detenido</li><li><a href="evperiodic.set.php">EvPeriodic::set</a> — Configura el watcher</li></ul>
</div>
<?php manual_footer($setup); ?>