Skip to content

Commit 409316a

Browse files
siwa32KentarouTakeda
siwa32
and
KentarouTakeda
authored
[PHP8.4]doc-en#4035とdoc-en#4102を翻訳 (#217)
* PHP-8.4: Document fpow() の翻訳 * PHP 8.4: Raising 0 to a negative exponent is deprecated の翻訳 * インデントや改行を原文と揃える対応 --------- Co-authored-by: 武田 憲太郎 <[email protected]>
1 parent 6ac95ae commit 409316a

File tree

3 files changed

+149
-4
lines changed

3 files changed

+149
-4
lines changed

‎reference/math/functions/fdiv.xml

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 9dba7a436d59e0418b902a3edd86748a00216926 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 2b7eebaaf61adf4b14a18a046f1a6c2b61cc8e72 Maintainer: mumumu Status: ready -->
44

55
<refentry xml:id="function.fdiv" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -81,9 +81,13 @@ var_dump(fdiv(0.0, 0.0)); // float(NAN)
8181
&reftitle.seealso;
8282
<para>
8383
<simplelist>
84-
<member><link linkend="language.operators.arithmetic"><literal>/</literal></link> - 浮動小数点数の除算</member>
84+
<member>
85+
除算演算子
86+
<link linkend="language.operators.arithmetic"><literal>/</literal></link>
87+
</member>
8588
<member><function>intdiv</function> - 整数値の除算</member>
86-
<member><function>fmod</function> - 剰余</member>
89+
<member><function>fmod</function></member>
90+
<member><function>fpow</function></member>
8791
</simplelist>
8892
</para>
8993
</refsect1>

‎reference/math/functions/fpow.xml

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 2b7eebaaf61adf4b14a18a046f1a6c2b61cc8e72 Maintainer: siwa32 Status: ready -->
3+
<!-- CREDITS: siwa32 -->
4+
<refentry xml:id="function.fpow" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>fpow</refname>
7+
<refpurpose>IEEE 754 に従い、数値をべき乗する</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type>float</type><methodname>fpow</methodname>
14+
<methodparam><type>float</type><parameter>num</parameter></methodparam>
15+
<methodparam><type>float</type><parameter>exponent</parameter></methodparam>
16+
</methodsynopsis>
17+
<simpara>
18+
<parameter>num</parameter> の
19+
<parameter>exponent</parameter> 乗の結果を浮動小数点数として返します。
20+
<parameter>num</parameter> が 0 で <parameter>exponent</parameter> が負数の場合は、
21+
<constant>INF</constant> を返します。
22+
</simpara>
23+
</refsect1>
24+
25+
<refsect1 role="parameters">
26+
&reftitle.parameters;
27+
<variablelist>
28+
<varlistentry>
29+
<term><parameter>num</parameter></term>
30+
<listitem>
31+
<simpara>
32+
使用する基数。
33+
</simpara>
34+
</listitem>
35+
</varlistentry>
36+
<varlistentry>
37+
<term><parameter>exponent</parameter></term>
38+
<listitem>
39+
<simpara>
40+
指数。
41+
</simpara>
42+
</listitem>
43+
</varlistentry>
44+
</variablelist>
45+
</refsect1>
46+
47+
<refsect1 role="returnvalues">
48+
&reftitle.returnvalues;
49+
<simpara>
50+
<code>$num<superscript>$exponent</superscript></code> を
51+
<type>float</type> で返します。
52+
</simpara>
53+
</refsect1>
54+
55+
<refsect1 role="examples">
56+
&reftitle.examples;
57+
<example xml:id="function.fpow.example.basic">
58+
<title><function>fpow</function> の例</title>
59+
<programlisting role="php">
60+
<![CDATA[
61+
<?php
62+
var_dump(fpow(10, 2));
63+
var_dump(fpow(0, -3));
64+
var_dump(fpow(-1, 5.5));
65+
?>
66+
]]>
67+
</programlisting>
68+
&example.outputs;
69+
<screen>
70+
<![CDATA[
71+
float(100)
72+
float(INF)
73+
float(NAN)
74+
]]>
75+
</screen>
76+
</example>
77+
</refsect1>
78+
79+
<refsect1 role="seealso">
80+
&reftitle.seealso;
81+
<simplelist>
82+
<member>
83+
べき乗演算子
84+
<link linkend="language.operators.arithmetic"><literal>**</literal></link>
85+
</member>
86+
<member><function>pow</function></member>
87+
<member><function>fdiv</function></member>
88+
<member><function>fmod</function></member>
89+
</simplelist>
90+
</refsect1>
91+
92+
</refentry>
93+
<!-- Keep this comment at the end of the file
94+
Local variables:
95+
mode: sgml
96+
sgml-omittag:t
97+
sgml-shorttag:t
98+
sgml-minimize-attributes:nil
99+
sgml-always-quote-attributes:t
100+
sgml-indent-step:1
101+
sgml-indent-data:t
102+
indent-tabs-mode:nil
103+
sgml-parent-document:nil
104+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
105+
sgml-exposed-tags:nil
106+
sgml-local-catalogs:nil
107+
sgml-local-ecat-files:nil
108+
End:
109+
vim600: syn=xml fen fdm=syntax fdl=2 si
110+
vim: et tw=78 syn=sgml
111+
vi: ts=1 sw=1
112+
-->

‎reference/math/functions/pow.xml

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7dbc44bd0d8923890acf1acedf79daba672af39c Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 0787a61e3614306bb3c0e5241396241e2d3ae4a7 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi -->
55
<refentry xml:id="function.pow" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -58,6 +58,30 @@
5858
PHP の拡張モジュールは、この演算の振る舞いを上書きし、オブジェクトを返させても構いません。
5959
</para>
6060
</refsect1>
61+
62+
<refsect1 role="changelog">
63+
&reftitle.changelog;
64+
<informaltable>
65+
<tgroup cols="2">
66+
<thead>
67+
<row>
68+
<entry>&Version;</entry>
69+
<entry>&Description;</entry>
70+
</row>
71+
</thead>
72+
<tbody>
73+
<row>
74+
<entry>8.4.0</entry>
75+
<entry>
76+
基数が <literal>0</literal> の場合に、
77+
<parameter>exponent</parameter> を負数とするのは非推奨となりました。
78+
</entry>
79+
</row>
80+
</tbody>
81+
</tgroup>
82+
</informaltable>
83+
</refsect1>
84+
6185
<refsect1 role="examples">
6286
&reftitle.examples;
6387
<para>
@@ -96,6 +120,11 @@ echo pow(-1, 5.5); // NAN
96120
&reftitle.seealso;
97121
<para>
98122
<simplelist>
123+
<member>
124+
べき乗演算子
125+
<link linkend="language.operators.arithmetic"><literal>**</literal></link>
126+
</member>
127+
<member><function>fpow</function></member>
99128
<member><function>exp</function></member>
100129
<member><function>sqrt</function></member>
101130
<member><function>bcpow</function></member>

0 commit comments

Comments
 (0)