<?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.evloop" role="class">

<title>La clase EvLoop</title>

<titleabbrev>EvLoop</titleabbrev>

<partintro>

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

&reftitle.intro;

<simpara>

Representa un bucle de eventos que siempre es distinto del

<emphasis>bucle por defecto</emphasis>. A diferencia del

<emphasis>bucle por defecto</emphasis>, no puede gestionar los

watchers <classname>EvChild</classname>.

</simpara>

<simpara>

Al utilizar hilos, se debe crear un bucle por hilo,

y utilizar el <emphasis>bucle por defecto</emphasis> en el hilo

padre.

</simpara>

<simpara>

El <emphasis>bucle de eventos por defecto</emphasis> es inicializado

automáticamente por <emphasis>Ev</emphasis>. Es accesible a través de los

métodos de la clase <classname>Ev</classname> o mediante el método

<methodname>EvLoop::defaultLoop</methodname>.

</simpara>

</section>

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

&reftitle.classsynopsis;

<classsynopsis>

<ooclass>

<classname>EvLoop</classname>

</ooclass>

<classsynopsisinfo>

<ooclass>

<modifier>final</modifier>

<classname>EvLoop</classname>

</ooclass>

</classsynopsisinfo>

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

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.data">data</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.backend">backend</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.is-default-loop">is_default_loop</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.iteration">iteration</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.pending">pending</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.io-interval">io_interval</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.timeout-interval">timeout_interval</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<varname linkend="evloop.props.depth">depth</varname>

</fieldsynopsis>

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

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

</classsynopsis>

</section>

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

&reftitle.properties;

<variablelist>

<varlistentry xml:id="evloop.props.data">

<term>

<varname>data</varname>

</term>

<listitem>

<simpara>

Datos personalizados para adjuntar al bucle

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evloop.props.backend">

<term>

<varname>backend</varname>

</term>

<listitem>

<simpara>

<emphasis>Solo lectura</emphasis>.

Los

<link linkend="ev.constants.watcher-backends">flags del backend</link>

que indican el backend de eventos en uso.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evloop.props.is-default-loop">

<term>

<varname>is_default_loop</varname>

</term>

<listitem>

<simpara>

<emphasis>Solo lectura</emphasis>.

&true; si es el bucle de eventos por defecto.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evloop.props.iteration">

<term>

<varname>iteration</varname>

</term>

<listitem>

<simpara>

El contador de iteración actual del bucle. Ver el método

<methodname>Ev::iteration</methodname>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evloop.props.pending">

<term>

<varname>pending</varname>

</term>

<listitem>

<simpara>

El número de watchers pendientes.

<literal>0</literal> indica que no hay watchers pendientes.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evloop.props.io-interval">

<term>

<varname>io_interval</varname>

</term>

<listitem>

<simpara>

Un valor alto para <varname>io_interval</varname> permite a

<emphasis>libev</emphasis> pasar más tiempo recolectando

los eventos <classname>EvIo</classname>, así, más eventos

pueden ser gestionados por iteración, pero esto aumentará la

latencia. Los tiempos de espera máximos (tanto para

<classname>EvPeriodic</classname> como para <classname>EvTimer</classname>)

no se verán afectados. Establecer esta opción a un valor

distinto de cero introducirá una llamada adicional a <literal>sleep()</literal>

en la mayoría de las iteraciones del bucle.

El tiempo de pausa asegura que <emphasis>libev</emphasis>

no consultará <classname>EvIo</classname> más de una vez

durante este intervalo, en promedio. La mayoría de los programas

pueden beneficiarse estableciendo

<varname>io_interval</varname> a un valor cercano a

<literal>0.1</literal>, lo cual es generalmente suficiente para los

servidores interactivos (y no destinados a juegos). Generalmente

no tiene sentido establecer este valor a menos de

<literal>0.01</literal>, ya que se acerca a la

granularidad a nivel de tiempos de la mayoría de los sistemas.

</simpara>

<simpara>

Ver también las

<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#FUNCTIONS_CONTROLLING_EVENT_LOOPS">

funciones que controlan los bucles de eventos</link>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evloop.props.timeout-interval">

<term>

<varname>timeout_interval</varname>

</term>

<listitem>

<simpara>

Un valor alto para <varname>timeout_interval</varname> permite a

<emphasis>libev</emphasis> pasar más tiempo recolectando los

tiempos de espera máximos, pero como consecuencia aumenta

la latencia, el estrés y la inexactitud (la función de retrollamada

del watcher será llamada más tarde). Los watchers <classname>EvIo</classname>

no se verán afectados. Establecer este valor a un valor no

nulo no introducirá ninguna sobrecarga adicional a

<emphasis>libev</emphasis>. Ver también las

<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#FUNCTIONS_CONTROLLING_EVENT_LOOPS">

funciones que controlan los bucles de eventos</link>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="evloop.props.depth">

<term>

<varname>depth</varname>

</term>

<listitem>

<simpara>

La profundidad de la recursión. Ver el método

<methodname>Ev::depth</methodname>.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</section>

</partintro>

&reference.ev.entities.evloop;

</reference>