Skip to content

Commit d48ef96

Browse files
mowangjuanzimowangjuanzi
committed
Update bc/classobj/com
1 parent d78027c commit d48ef96

File tree

5 files changed

+736
-650
lines changed

5 files changed

+736
-650
lines changed

‎reference/bc/functions/bcdiv.xml

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: jakquan Status: ready -->
3+
<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: jakquan Status: ready -->
4+
<!-- CREDITS: mowangjuanzi -->
45
<refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook">
56
<refnamediv>
67
<refname>bcdiv</refname>
@@ -48,10 +49,24 @@
4849
<refsect1 role="returnvalues">
4950
&reftitle.returnvalues;
5051
<para>
51-
返回字符串类型的结果。如果 <parameter>num2</parameter> 是 <literal>0</literal> 结果为 &null;。
52+
返回字符串类型的除法结果。
5253
</para>
5354
</refsect1>
5455

56+
<refsect1 role="errors">
57+
&reftitle.errors;
58+
<para>
59+
函数在下列情况会抛出 <exceptionname>ValueError</exceptionname>：
60+
<simplelist>
61+
<member><parameter>num1</parameter> 或 <parameter>num2</parameter> 不是格式正确的 BCMath 数字字符串</member>
62+
<member><parameter>scale</parameter> 超出有效范围</member>
63+
</simplelist>
64+
</para>
65+
<simpara>
66+
如果 <parameter>num2</parameter> 为 <literal>0</literal>，此函数会抛出 <exceptionname>DivisionByZeroError</exceptionname> 异常。
67+
</simpara>
68+
</refsect1>
69+
5570
<refsect1 role="changelog">
5671
&reftitle.changelog;
5772
<informaltable>
@@ -69,6 +84,12 @@
6984
现在 <parameter>scale</parameter> 可以为 null。
7085
</entry>
7186
</row>
87+
<row>
88+
<entry>8.0.0</entry>
89+
<entry>
90+
现在，除以 0 会引发 <exceptionname>DivisionByZeroError</exceptionname> 异常，而不是返回 &null;。
91+
</entry>
92+
</row>
7293
</tbody>
7394
</tgroup>
7495
</informaltable>
@@ -94,6 +115,8 @@ echo bcdiv('105', '6.55957', 3); // 16.007
94115
&reftitle.seealso;
95116
<para>
96117
<simplelist>
118+
<member><function>bcdivmod</function></member>
119+
<member><function>bcmod</function></member>
97120
<member><function>bcmul</function></member>
98121
</simplelist>
99122
</para>

‎reference/bc/functions/bcmod.xml

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: jakquan Status: ready -->
4-
<!-- Reviewed: no -->
5-
3+
<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: jakquan Status: ready -->
4+
<!-- CREDITS: mowangjuanzi -->
65
<refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook">
76
<refnamediv>
87
<refname>bcmod</refname>
@@ -44,15 +43,30 @@
4443
</para>
4544
</listitem>
4645
</varlistentry>
46+
&bc.scale.description;
4747
</variablelist>
4848
</para>
4949
</refsect1>
5050

5151
<refsect1 role="returnvalues">
5252
&reftitle.returnvalues;
5353
<para>
54-
返回字符串类型取模后的结果，如果 <parameter>num2</parameter> 为 0 则返回 &null;。
54+
返回字符串类型取模后的结果。
55+
</para>
56+
</refsect1>
57+
58+
<refsect1 role="errors">
59+
&reftitle.errors;
60+
<para>
61+
函数在下列情况会抛出 <exceptionname>ValueError</exceptionname>：
62+
<simplelist>
63+
<member><parameter>num1</parameter> 或 <parameter>num2</parameter> 不是格式正确的 BCMath 数字字符串</member>
64+
<member><parameter>scale</parameter> 超出有效范围</member>
65+
</simplelist>
5566
</para>
67+
<simpara>
68+
如果 <parameter>num2</parameter> 为 <literal>0</literal>，此函数会抛出 <exceptionname>DivisionByZeroError</exceptionname> 异常。
69+
</simpara>
5670
</refsect1>
5771

5872
<refsect1 role="changelog"><!-- {{{ -->
@@ -72,6 +86,12 @@
7286
现在 <parameter>scale</parameter> 可以为 null。
7387
</entry>
7488
</row>
89+
<row>
90+
<entry>8.0.0</entry>
91+
<entry>
92+
现在，除以 0 会引发 <exceptionname>DivisionByZeroError</exceptionname> 异常，而不是返回 &null;。
93+
</entry>
94+
</row>
7595
<row>
7696
<entry>7.2.0</entry>
7797
<entry>
@@ -126,6 +146,7 @@ echo bcmod('5.7', '1.3'); // PHP 7.2.0 起是 0.5；之前是 0
126146
<para>
127147
<simplelist>
128148
<member><function>bcdiv</function></member>
149+
<member><function>bcdivmod</function></member>
129150
</simplelist>
130151
</para>
131152
</refsect1>

‎reference/bc/functions/bcpow.xml

Lines changed: 31 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: jakquan Status: ready -->
4-
<!-- Reviewed: no -->
5-
3+
<!-- EN-Revision: e333514f66ae32a3468e05dbe64f55f01ff9451e Maintainer: jakquan Status: ready -->
4+
<!-- CREDITS: mowangjuanzi -->
65
<refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook">
76
<refnamediv>
87
<refname>bcpow</refname>
@@ -38,8 +37,7 @@
3837
<term><parameter>exponent</parameter></term>
3938
<listitem>
4039
<para>
41-
string 类型的指数。 如果指数不是整数，将被截断。
42-
指数的有效范围取决于平台，但起码支持
40+
string 类型的指数。必须是没有小数部分的值。指数的有效范围取决于平台，但起码支持
4341
<literal>-2147483648</literal> 到 <literal>2147483647</literal> 的范围。
4442
</para>
4543
</listitem>
@@ -56,6 +54,22 @@
5654
</para>
5755
</refsect1>
5856

57+
<refsect1 role="errors">
58+
&reftitle.errors;
59+
<para>
60+
函数在下列情况会抛出 <exceptionname>ValueError</exceptionname>：
61+
<simplelist>
62+
<member><parameter>num</parameter> 或 <parameter>exponent</parameter> 不是格式正确的 BCMath 数字字符串</member>
63+
<member><parameter>scale</parameter> 超出有效范围</member>
64+
<member><parameter>exponent</parameter> 有小数部分</member>
65+
</simplelist>
66+
</para>
67+
<simpara>
68+
如果 <parameter>num</parameter> 为 <literal>0</literal> 且 <parameter>exponent</parameter>
69+
为负值，则此函数抛出 <exceptionname>DivisionByZeroError</exceptionname> 异常。
70+
</simpara>
71+
</refsect1>
72+
5973
<refsect1 role="changelog"><!-- {{{ -->
6074
&reftitle.changelog;
6175
<informaltable>
@@ -67,6 +81,18 @@
6781
</row>
6882
</thead>
6983
<tbody>
84+
<row>
85+
<entry>8.4.0</entry>
86+
<entry>
87+
0 的负幂以前返回 0，但现在会引发 <exceptionname>DivisionByZeroError</exceptionname> 异常。
88+
</entry>
89+
</row>
90+
<row>
91+
<entry>8.0.0</entry>
92+
<entry>
93+
当 <parameter>exponent</parameter> 有小数部分时，现在会抛出 <exceptionname>ValueError</exceptionname> 而不是截断。
94+
</entry>
95+
</row>
7096
<row>
7197
<entry>7.3.0</entry>
7298
<entry>

‎reference/classobj/setup.xml

Lines changed: 0 additions & 35 deletions
This file was deleted.

0 commit comments

Comments
 (0)