initial translation

php · Nov 17, 2024 · c6c765d · c6c765d
1 parent d054478
commit c6c765d
Show file tree

Hide file tree

Showing 4 changed files with 341 additions and 0 deletions.
diff --git a/reference/math/functions/fpow.xml b/reference/math/functions/fpow.xml
@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2b7eebaaf61adf4b14a18a046f1a6c2b61cc8e72 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="function.fpow" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>fpow</refname>
+  <refpurpose>Eleva um número à potência de outro, de acordo com a IEEE 754</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>float</type><methodname>fpow</methodname>
+   <methodparam><type>float</type><parameter>num</parameter></methodparam>
+   <methodparam><type>float</type><parameter>exponent</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Retorna o resultado em ponto flutuante da elevação de
+   <parameter>num</parameter> à potência de <parameter>exponent</parameter>.
+   Se <parameter>num</parameter> for zero e <parameter>exponent</parameter>
+   for menor que zero, retorna <constant>INF</constant>.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>num</parameter></term>
+    <listitem>
+     <simpara>
+      A base a ser usada.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>exponent</parameter></term>
+    <listitem>
+     <simpara>
+      O expoente.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   Retorna um <type>float</type> correspondente a
+   <code>$num<superscript>$exponent</superscript></code>.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.fpow.example.basic">
+   <title>Exemplo de <function>fpow</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+var_dump(fpow(10, 2));
+var_dump(fpow(0, -3));
+var_dump(fpow(-1, 5.5));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+float(100)
+float(INF)
+float(NAN)
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member>
+    Operador de exponenciação
+    <link linkend="language.operators.arithmetic"><literal>**</literal></link>
+   </member>
+   <member><function>pow</function></member>
+   <member><function>fdiv</function></member>
+   <member><function>fmod</function></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/reflection/reflectionproperty/islazy.xml b/reference/reflection/reflectionproperty/islazy.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="reflectionproperty.islazy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>ReflectionProperty::isLazy</refname>
+  <refpurpose>Verifica se uma propriedade é lenta</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="ReflectionProperty">
+   <modifier>public</modifier> <type>bool</type><methodname>ReflectionProperty::isLazy</methodname>
+   <methodparam><type>object</type><parameter>object</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Verifica se uma propriedade é lenta.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>object</parameter></term>
+    <listitem>
+     <simpara>
+      O objeto no qual a propriedade será verificada.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   Retorna &true; se a propriedade for lenta, &false; caso contrário.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><link linkend="language.oop5.lazy-objects">Objetos lentos</link></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/reflection/reflectionproperty/setrawvaluewithoutlazyinitialization.xml b/reference/reflection/reflectionproperty/setrawvaluewithoutlazyinitialization.xml
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="reflectionproperty.setrawvaluewithoutlazyinitialization" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>ReflectionProperty::setRawValueWithoutLazyInitialization</refname>
+  <refpurpose>Define o valor bruto da propriedade sem acionar a inicialização lenta</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="ReflectionProperty">
+   <modifier>public</modifier> <type>void</type><methodname>ReflectionProperty::setRawValueWithoutLazyInitialization</methodname>
+   <methodparam><type>object</type><parameter>object</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Define (altera) o valor da propriedade sem acionar a inicialização lenta
+   e sem chamar funções de gancho.
+   A propriedade é marcada como não lenta e pode ser acessada posteriormente sem
+   acionar a inicialização lenta.
+   A propriedade não deve ser dinâmica, estática ou virtual e o objeto deve ser
+   uma instância de uma classe definida pelo usuário ou <classname>stdClass</classname>.
+  </simpara>
+  <simpara>
+   Se esta for a última propriedade lenta, o objeto será marcado como não lento e o
+   inicializador ou função de fábrica será desanexado.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>object</parameter></term>
+    <listitem>
+     <simpara>
+      O objeto que terá a propriedade alterada.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>value</parameter></term>
+    <listitem>
+     <simpara>
+      O novo valor.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   &return.void;
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><link linkend="language.oop5.lazy-objects">Objetos lentos</link></member>
+   <member><methodname>ReflectionProperty::skipLazyInitialization</methodname></member>
+   <member><methodname>ReflectionClass::newLazyGhost</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/reflection/reflectionproperty/skiplazyinitialization.xml b/reference/reflection/reflectionproperty/skiplazyinitialization.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c0fa5077c8862405942d8aac7360c5169558b59b Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="reflectionproperty.skiplazyinitialization" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>ReflectionProperty::skipLazyInitialization</refname>
+  <refpurpose>Marca a propriedade como não lenta</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="ReflectionProperty">
+   <modifier>public</modifier> <type>void</type><methodname>ReflectionProperty::skipLazyInitialization</methodname>
+   <methodparam><type>object</type><parameter>object</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Marca uma propriedade como não lenta, de modo que ela possa ser acessada diretamente sem
+   acionar a inicialização lenta. A propriedade é inicializada com seu valor
+   padrão, se houver.
+   A propriedade não deve ser dinâmica, estática ou virtual e o objeto deve ser
+   uma instância de uma classe definida pelo usuário ou <classname>stdClass</classname>.
+  </simpara>
+  <simpara>
+   Se esta for a última propriedade lenta, o objeto será marcado como não lento e o
+   inicializador ou função de fábrica será desanexado.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>object</parameter></term>
+    <listitem>
+     <simpara>
+      O objeto que terá a propriedade marcada.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   &return.void;
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><link linkend="language.oop5.lazy-objects">Objetos lentos</link></member>
+   <member><methodname>ReflectionProperty::setRawValueWithoutLazyInitialization</methodname></member>
+   <member><methodname>ReflectionClass::newLazyGhost</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
+-->