[PHP8.4]doc-en#4035とdoc-en#4102を翻訳

reference/math/functions/fdiv.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9dba7a436d59e0418b902a3edd86748a00216926 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 2b7eebaaf61adf4b14a18a046f1a6c2b61cc8e72 Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="function.fdiv" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -81,9 +81,10 @@ var_dump(fdiv(0.0, 0.0)); // float(NAN)
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><link linkend="language.operators.arithmetic"><literal>/</literal></link> - 浮動小数点数の除算</member>
+    <member>除算演算子 <link linkend="language.operators.arithmetic"><literal>/</literal></link></member>
     <member><function>intdiv</function> - 整数値の除算</member>
-    <member><function>fmod</function> - 剰余</member>
+    <member><function>fmod</function></member>
+    <member><function>fpow</function></member>
    </simplelist>
   </para>
  </refsect1>

reference/math/functions/fpow.xml

@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 2b7eebaaf61adf4b14a18a046f1a6c2b61cc8e72 Maintainer: siwa32 Status: ready -->
+<!-- CREDITS: siwa32 -->
+<refentry xml:id="function.fpow" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>fpow</refname>
+  <refpurpose>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>
+   <parameter>num</parameter> の
+   <parameter>exponent</parameter> 乗の結果を浮動小数点数として返します。
+   <parameter>num</parameter> が 0 で <parameter>exponent</parameter> が負数の場合は、
+   <constant>INF</constant> を返します。
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>num</parameter></term>
+    <listitem>
+     <simpara>
+      使用する基数。
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>exponent</parameter></term>
+    <listitem>
+     <simpara>
+      指数。
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   <code>$num<superscript>$exponent</superscript></code> を
+   <type>float</type> で返します。
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.fpow.example.basic">
+   <title><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>
+    べき乗演算子
+    <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
+-->

reference/math/functions/pow.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7dbc44bd0d8923890acf1acedf79daba672af39c Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 0787a61e3614306bb3c0e5241396241e2d3ae4a7 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi -->
 <refentry xml:id="function.pow" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -58,6 +58,30 @@
    PHP の拡張モジュールは、この演算の振る舞いを上書きし、オブジェクトを返させても構いません。
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       基数が <literal>0</literal> の場合に、
+       <parameter>exponent</parameter> を負数とするのは非推奨となりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -96,6 +120,11 @@ echo pow(-1, 5.5); // NAN
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member>
+     べき乗演算子
+     <link linkend="language.operators.arithmetic"><literal>**</literal></link>
+    </member>
+    <member><function>fpow</function></member>
     <member><function>exp</function></member>
     <member><function>sqrt</function></member>
     <member><function>bcpow</function></member>