From 656f427bd55a5972ad7577017ce350b45fcc0810 Mon Sep 17 00:00:00 2001
From: Fernando Wobeto <fernandowobeto@gmail.com>
Date: Sat, 16 Nov 2024 15:15:01 -0300
Subject: [PATCH] =?UTF-8?q?Tradu=C3=A7=C3=A3o=20em=20reference/ev/evperiod?=
 =?UTF-8?q?ic=20(#706)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* inclusão dos arquivos originais com revisão atualizada

* tradução em reference/ev/evperiodic

* Update createstopped.xml
---
 reference/ev/evperiodic/again.xml         |  59 +++++++
 reference/ev/evperiodic/at.xml            |  57 ++++++
 reference/ev/evperiodic/construct.xml     | 204 ++++++++++++++++++++++
 reference/ev/evperiodic/createstopped.xml | 159 +++++++++++++++++
 reference/ev/evperiodic/set.xml           |  84 +++++++++
 5 files changed, 563 insertions(+)
 create mode 100644 reference/ev/evperiodic/again.xml
 create mode 100644 reference/ev/evperiodic/at.xml
 create mode 100644 reference/ev/evperiodic/construct.xml
 create mode 100644 reference/ev/evperiodic/createstopped.xml
 create mode 100644 reference/ev/evperiodic/set.xml

diff --git a/reference/ev/evperiodic/again.xml b/reference/ev/evperiodic/again.xml
new file mode 100644
index 000000000..7f553030c
--- /dev/null
+++ b/reference/ev/evperiodic/again.xml
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: dd07341fae2c414adc1f700be0890ff32e8daab4 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.again" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::again</refname>
+  <refpurpose>Simplesmente para e reinicia o observador periódico novamente</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier>
+   <type>void</type>
+   <methodname>EvPeriodic::again</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   Simplesmente para e reinicia o observador periódico novamente. Isso só é útil
+   quando os atributos são alterados.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member>
+    <methodname>EvTimer::again</methodname>
+   </member>
+  </simplelist>
+ </refsect1>
+</refentry>
+<!-- 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
+-->
diff --git a/reference/ev/evperiodic/at.xml b/reference/ev/evperiodic/at.xml
new file mode 100644
index 000000000..09c67de4a
--- /dev/null
+++ b/reference/ev/evperiodic/at.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.at" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::at</refname>
+  <refpurpose>Retorna o tempo absoluto em que este observador
+  deve disparar em seguida</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier>
+   <type>float</type>
+   <methodname>EvPeriodic::at</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   Quando o observador está ativo, retorna o tempo absoluto em que este observador
+   deve disparar em seguida. Isso não é o mesmo que o argumento offset para
+   <methodname>EvPeriodic::set</methodname>
+   ou
+   <methodname>EvPeriodic::__construct</methodname>,
+   mas funciona mesmo no modo de intervalo.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna o tempo absoluto que este observador deve disparar em seguida em
+   segundos.
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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
+-->
diff --git a/reference/ev/evperiodic/construct.xml b/reference/ev/evperiodic/construct.xml
new file mode 100644
index 000000000..e8bcec3dc
--- /dev/null
+++ b/reference/ev/evperiodic/construct.xml
@@ -0,0 +1,204 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 33e5f4ef7243bc1282acb1cba93e8f99c1debe68 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::__construct</refname>
+  <refpurpose>Constrói objeto observador EvPeriodic</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <constructorsynopsis>
+   <modifier>public</modifier>
+   <methodname>EvPeriodic::__construct</methodname>
+   <methodparam>
+    <type>float</type>
+    <parameter>offset</parameter>
+   </methodparam>
+   <methodparam>
+    <type>string</type>
+    <parameter>interval</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>reschedule_cb</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>callback</parameter>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>mixed</type>
+    <parameter>data</parameter>
+    <initializer>&null;</initializer>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>int</type>
+    <parameter>priority</parameter>
+    <initializer>0</initializer>
+   </methodparam>
+  </constructorsynopsis>
+  <para>
+   Constrói o objeto observador EvPeriodic e o inicia automaticamente.
+   O método <methodname>EvPeriodic::createStopped</methodname>
+   cria o observador periódico parado.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term>
+     <parameter>offset</parameter>
+    </term>
+    <listitem>
+     <para>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>interval</parameter>
+    </term>
+    <listitem>
+     <para>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>reschedule_cb</parameter>
+    </term>
+    <listitem>
+     <para>
+      Reprograma retorno de chamada. Você pode passar &null;. Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador
+      periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>callback</parameter>
+    </term>
+    <listitem>
+     <para>
+      Veja
+      <link linkend="ev.watcher-callbacks">Retornos de chamada do observador</link>
+      .
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>data</parameter>
+    </term>
+    <listitem>
+     <para>
+      Dados personalizados associados ao observador.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>priority</parameter>
+    </term>
+    <listitem>
+     <para>
+      <link linkend="ev.constants.watcher-pri">Prioridade do observador</link>
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+
+ <example>
+   <title>Temporizador periódico. Usar retorno de chamada de reagendamento</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Marca a cada 10,5 segundos
+
+function reschedule_cb ($watcher, $now) {
+ return $now + (10.5. - fmod($now, 10.5));
+}
+
+$w = new EvPeriodic(0., 0., "reschedule_cb", function ($w, $revents) {
+ echo time(), PHP_EOL;
+});
+Ev::run();
+?>
+
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>Temporizador periódico. Marca a cada 10,5 segundos a partir de agora</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Marca a cada 10,5 segundos a partir de agora
+$w = new EvPeriodic(fmod(Ev::now(), 10.5), 10.5, NULL, function ($w, $revents) {
+ echo time(), PHP_EOL;
+});
+Ev::run();
+?>
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>Observador de hora em hora</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$hourly = EvPeriodic(0, 3600, NULL, function () {
+ echo "uma vez por hora\n";
+});
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member>
+    <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
+   </member>
+   <member>
+    <classname>EvTimer</classname>
+   </member>
+   <member>
+    <methodname>EvPeriodic::createStopped</methodname>
+   </member>
+  </simplelist>
+ </refsect1>
+</refentry>
+<!-- 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
+-->
diff --git a/reference/ev/evperiodic/createstopped.xml b/reference/ev/evperiodic/createstopped.xml
new file mode 100644
index 000000000..ad97ea6fe
--- /dev/null
+++ b/reference/ev/evperiodic/createstopped.xml
@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::createStopped</refname>
+  <refpurpose>Cria um observador EvPeriodic parado</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>final</modifier>
+   <modifier>public</modifier>
+   <modifier>static</modifier>
+   <type>EvPeriodic</type>
+   <methodname>EvPeriodic::createStopped</methodname>
+   <methodparam>
+    <type>float</type>
+    <parameter>offset</parameter>
+   </methodparam>
+   <methodparam>
+    <type>float</type>
+    <parameter>interval</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>reschedule_cb</parameter>
+   </methodparam>
+   <methodparam>
+    <type>callable</type>
+    <parameter>callback</parameter>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>mixed</type>
+    <parameter>data</parameter>
+    <initializer>&null;</initializer>
+   </methodparam>
+   <methodparam
+   choice="opt">
+    <type>int</type>
+    <parameter>priority</parameter>
+    <initializer>0</initializer>
+   </methodparam>
+  </methodsynopsis>
+  <para>
+   Cria um objeto EvPeriodic. Ao contrário de
+   <methodname>EvPeriodic::__construct</methodname>,
+   este método não inicia o observador automaticamente.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term>
+     <parameter>offset</parameter>
+    </term>
+    <listitem>
+     <para>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>interval</parameter>
+    </term>
+    <listitem>
+     <para>
+      Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>reschedule_cb</parameter>
+    </term>
+    <listitem>
+     <para>
+      Reprogramaa retorno de chamada. Você pode passar &null;. Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador
+      periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>callback</parameter>
+    </term>
+    <listitem>
+     <para>
+      Veja
+      <link linkend="ev.watcher-callbacks">Retornos de chamada do observador</link>
+      .
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>data</parameter>
+    </term>
+    <listitem>
+     <para>
+      Dados personalizados associados ao observador.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>priority</parameter>
+    </term>
+    <listitem>
+     <para>
+      <link linkend="ev.constants.watcher-pri">Prioridade do observador</link>
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna o objeto observador EvPeriodic em caso de sucesso.
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member>
+    <methodname>EvPeriodic::__construct</methodname>
+   </member>
+   <member>
+    <methodname>EvTimer::createStopped</methodname>
+   </member>
+  </simplelist>
+ </refsect1>
+</refentry>
+<!-- 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
+-->
diff --git a/reference/ev/evperiodic/set.xml b/reference/ev/evperiodic/set.xml
new file mode 100644
index 000000000..80bd3c403
--- /dev/null
+++ b/reference/ev/evperiodic/set.xml
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 508869e1df6458162c162d71669f5e81abd65d50 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<refentry xml:id="evperiodic.set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>EvPeriodic::set</refname>
+  <refpurpose>Configura o observador</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier>
+   <type>void</type>
+   <methodname>EvPeriodic::set</methodname>
+   <methodparam>
+    <type>float</type>
+    <parameter>offset</parameter>
+   </methodparam>
+   <methodparam>
+    <type>float</type>
+    <parameter>interval</parameter>
+   </methodparam>
+  </methodsynopsis>
+  <para>
+   (Re-)Configura o observador EvPeriodic
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term>
+     <parameter>offset</parameter>
+    </term>
+    <listitem>
+     <para>
+      O mesmo significado que para
+      <methodname>EvPeriodic::__construct</methodname>
+      . Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term>
+     <parameter>interval</parameter>
+    </term>
+    <listitem>
+     <para>
+      O mesmo significado que para
+      <methodname>EvPeriodic::__construct</methodname>
+      . Veja
+      <link linkend="ev.periodic-modes">Modos de operação do observador periódico</link>
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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
+-->