Files
archived-doc-pt-br/reference/ev/evloop.xml
Leonardo Lara Rodrigues 17d859faaf sync line numbers with en rev
2026-01-23 09:16:58 -03:00

256 lines
8.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b4fbf4434abeca44c58575ff3967e5640f7877d5 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<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>A classe EvLoop</title>
<titleabbrev>EvLoop</titleabbrev>
<partintro>
<!-- {{{ EvLoop intro -->
<section xml:id="evloop.intro">
&reftitle.intro;
<simpara>
Representa um laço de eventos que é sempre distinto do
<emphasis>laço
padrão</emphasis>.
Ao contrário do
<emphasis>laço padrão</emphasis>,
ele não pode lidar
com observadores
<classname>EvChild</classname>.
</simpara>
<simpara>
Tendo threads, temos que criar um laço por thread e usar o
<emphasis>laço padrão</emphasis>
no thread pai.
</simpara>
<simpara>
O
<emphasis>laço de eventos padrão</emphasis>
é inicializado automaticamente por
<emphasis>Ev</emphasis>.
É acessível através de métodos
da classe
<classname>Ev</classname>, ou através
do método
<methodname>EvLoop::defaultLoop</methodname>.
</simpara>
</section>
<!-- }}} -->
<section xml:id="evloop.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass>
<classname>EvLoop</classname>
</ooclass>
<!-- {{{ Class synopsis -->
<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>
<!-- {{{ EvLoop properties -->
<section xml:id="evloop.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="evloop.props.data">
<term>
<varname>data</varname>
</term>
<listitem>
<simpara>
Dados personalizados anexados ao laço
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evloop.props.backend">
<term>
<varname>backend</varname>
</term>
<listitem>
<simpara>
<emphasis>Somente Leitura</emphasis>.
As
<link linkend="ev.constants.watcher-backends">opções de backend</link>
indicando o backend do evento em uso.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evloop.props.is-default-loop">
<term>
<varname>is_default_loop</varname>
</term>
<listitem>
<simpara>
<emphasis>Somente Leitura</emphasis>.
&true; se for o laço de eventos padrão.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evloop.props.iteration">
<term>
<varname>iteration</varname>
</term>
<listitem>
<simpara>
A contagem de iterações atuais do laço. Veja
<methodname>Ev::iteration</methodname>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evloop.props.pending">
<term>
<varname>pending</varname>
</term>
<listitem>
<simpara>
O número de observadores pendentes.
<literal>0</literal>
indica que não há observadores pendentes.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evloop.props.io-interval">
<term>
<varname>io_interval</varname>
</term>
<listitem>
<simpara>
Um
<varname>io_interval</varname> mais alto
permite que
<emphasis>libev</emphasis>
gaste mais tempo coletando eventos
<classname>EvIo</classname>,
para que mais eventos possam ser tratados por iteração, ao custo de
aumentar a latência. Os tempos limite
(<classname>EvPeriodic</classname>
e
<classname>EvTimer</classname>)
não serão afetados. Definir isso com um valor diferente de zero introduzirá
uma chamada
<literal>sleep()</literal>
adicional na maioria das iterações de laço. O tempo de suspensão garante que
<emphasis>libev</emphasis>
não pesquisará eventos
<classname>EvIo</classname>
mais de uma vez por esse intervalo, em média. Muitos
programas geralmente podem se beneficiar configurando o
<varname>io_interval</varname>
para um valor próximo de
<literal>0.1</literal>,
o que geralmente é suficiente para servidores interativos (não para jogos). Geralmente
não faz muito sentido defini-lo com um valor inferior a
<literal>0.01</literal>,
pois isso se aproxima da granularidade de tempo da maioria dos sistemas.
</simpara>
<simpara>
Veja também
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#FUNCTIONS_CONTROLLING_EVENT_LOOPS">FUNÇÕES DE
CONTROLE DE LAÇOS DE EVENTOS</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evloop.props.timeout-interval">
<term>
<varname>timeout_interval</varname>
</term>
<listitem>
<simpara>
Um
<varname>timeout_interval</varname>
maior permite que
<emphasis>libev</emphasis>
gaste mais tempo coletando tempos limite, às custas de maior
latência/jitter/inexatidão (o retorno de chamada do inspetor será chamado mais tarde).
Os observadores de <classname>EvIo</classname>
não serão afetados. Definir isso como um valor não nulo não
introduzirá nenhuma sobrecarga no
<emphasis>libev</emphasis>.
Veja também
<link xlink:href="http://pod.tst.eu/http://cvs.schmorp.de/libev/ev.pod#FUNCTIONS_CONTROLLING_EVENT_LOOPS">FUNÇÕES DE
CONTROLE DE LAÇOS DE EVENTOS</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="evloop.props.depth">
<term>
<varname>depth</varname>
</term>
<listitem>
<simpara>
A profundidade da recursão. Veja
<methodname>Ev::depth</methodname>.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- }}} -->
</partintro>
&reference.ev.entities.evloop;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->