<?xml version="1.0" encoding="utf-8"?>

<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.evtimer" role="class">

<title>La clase EvTimer</title>

<titleabbrev>EvTimer</titleabbrev>

<partintro>

<section xml:id="evtimer.intro">

&reftitle.intro;

<simpara>

Los observadores <classname>EvTimer</classname> son observadores relativamente

simples que generan un evento después de un tiempo especificado y, opcionalmente,

se repiten a intervalos regulares.

</simpara>

<simpara>

Los temporizadores se basan en tiempo real, por lo que si un temporizador

programa un evento que finaliza después de una hora y se reinicia el reloj del sistema

a <emphasis>enero del año pasado</emphasis>, volverá a estar fuera de tiempo

después de una hora (aproximadamente). "Aproximadamente" porque la detección de

saltos en el tiempo es difícil y ciertas inexactitudes son inevitables.

</simpara>

<simpara>

Se garantiza que la función de retrollamada se llamará solo después de que

expire el tiempo de espera máximo (y no exactamente en ese momento preciso,

por lo que en sistemas con una resolución de reloj baja, puede introducirse

un pequeño retraso). Si varios temporizadores están listos durante la misma

iteración del bucle, el que tenga el valor de tiempo de espera máximo más cercano

se invocará antes que otro con la misma prioridad pero con un valor de tiempo

de espera más lejano (aunque esto ya no es cierto cuando una función de retrollamada

llama recursivamente al método <methodname>EvLoop::run</methodname>).

</simpara>

<simpara>

El temporizador en sí hará todo lo posible para no derivar, pero si un temporizador

está configurado para ejecutarse cada <literal>10</literal> segundos, entonces

normalmente se ejecutará exactamente cada <literal>10</literal> segundos.

Sin embargo, si el script no puede mantener el temporizador porque tarda más

que sus <literal>10</literal> segundos, el temporizador no podrá ejecutarse

más de una vez por iteración del bucle de eventos.

</simpara>

</section>

<section xml:id="evtimer.synopsis">

&reftitle.classsynopsis;

<classsynopsis>

<ooclass>

<classname>EvTimer</classname>

</ooclass>

<classsynopsisinfo>

<ooclass>

<classname>EvTimer</classname>

</ooclass>

<ooclass>

<modifier>extends</modifier>

<classname>EvWatcher</classname>

</ooclass>

</classsynopsisinfo>

<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evtimer.props.repeat">repeat</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evtimer.props.remaining">remaining</varname>

</fieldsynopsis>

<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('evwatcher.synopsis')/descendant::db:fieldsynopsis)"/>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evtimer')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"/>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evtimer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>

<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.evwatcher')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])"/>

</classsynopsis>

</section>

<section xml:id="evtimer.props">

&reftitle.properties;

<variablelist>

<varlistentry xml:id="evtimer.props.repeat">

<term>

<varname>repeat</varname>

</term>

<listitem>

<simpara>

Si esta propiedad vale <literal>0.0</literal>, entonces se detendrá automáticamente

una vez alcanzado el tiempo de espera máximo. Si es positivo, entonces el temporizador

se configurará automáticamente para ejecutarse cada segundo siguiente, hasta que

no se detenga manualmente.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evtimer.props.remaining">

<term>

<varname>remaining</varname>

</term>

<listitem>

<simpara>

Devuelve el tiempo restante antes de que el temporizador se ejecute.

Si el temporizador está activo, entonces este tiempo será relativo al tiempo

del bucle de eventos actual, de lo contrario, será relativo al valor del

tiempo de espera máximo configurado actualmente.

</simpara>

<simpara>

Asimismo, después de instanciar un <classname>EvTimer</classname>

con un valor de <parameter>after</parameter> en

<literal>5.0</literal> y un valor de <parameter>repeat</parameter>

en <literal>7.0</literal>, <varname>remaining</varname> devolverá

<literal>5.0</literal>. Cuando el temporizador se inicia y pasa un

segundo, <varname>remaining</varname> devolverá

<literal>4.0</literal>. Cuando el temporizador expire y se reinicie,

devolverá aproximadamente <literal>7.0</literal>

(probablemente un poco menos, ya que la invocación de la función de retrollamada

también lleva algo de tiempo), y así sucesivamente.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</section>

</partintro>

&reference.ev.entities.evtimer;

</reference>