Skip to content

Commit 2ab48cf

Browse files
SakiTakamachiSakiTakamachi
authored
ext/bcmath: PHP 8.4の翻訳 (#257)
* 翻訳者に自身を追加 * bcmath.numberのクラスページ翻訳 * BcMath\Number関連を翻訳 * 新しい4つのBCMath関数の翻訳 * 既存関数の更新分を翻訳 * BCMathのbookとiniの更新分を追加 * 構文エラー修正 * statusがworkingのものをreadyに変更 * 最新のenのBCMath関連の変更を適用 * 残っていた英語削除 * s/exception/例外 * Example of using 削除 * s/,/、/
1 parent e3bc14b commit 2ab48cf

36 files changed

+3767
-66
lines changed

‎language-snippets.ent

Lines changed: 1 addition & 15 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: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: takagi Status: working -->
3+
<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: takagi Status: working -->
44
<!-- Credits: hirokawa,haruki,shimooka,mumumu,jdkfx -->
55

66
<!ENTITY installation.enabled.disable 'この拡張モジュールはデフォルトで有効になっています。無効にしたい場合は、次のオプションを指定してコンパイルします。'>
@@ -2121,20 +2121,6 @@ PECL 拡張モジュールのインストール</link> という章にありま
21212121

21222122
<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">SQL セーフモード</link>'>
21232123

2124-
<!-- BCMath Notes -->
2125-
<!-- to be translated -->
2126-
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
2127-
<term><parameter>scale</parameter></term>
2128-
<listitem>
2129-
<simpara>
2130-
This parameter is used to set the number of digits after the decimal place in the result.
2131-
If &null;, it will default to the default scale set with <function>bcscale</function>,
2132-
or fallback to the value of the
2133-
<link linkend="ini.bcmath.scale"><literal>bcmath.scale</literal></link> INI directive.
2134-
</simpara>
2135-
</listitem>
2136-
</varlistentry>'>
2137-
21382124
<!-- CTYPE Notes -->
21392125
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
21402126
-128 から 255 までの <type>int</type> を渡すと、ひとつの文字の ASCII 値とみなします

‎reference/bc/bcmath.number.xml

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: saki Status: ready -->
4+
5+
<reference xml:id="class.bcmath-number" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
6+
7+
<title>BcMath\Number クラス</title>
8+
<titleabbrev>BcMath\Number</titleabbrev>
9+
10+
<partintro>
11+
<section xml:id="bcmath-number.intro">
12+
&reftitle.intro;
13+
<simpara>
14+
任意精度数値のクラスです。
15+
このオブジェクトは、オーバーロードされた
16+
<link linkend="language.operators.arithmetic">算術演算子</link>,
17+
<link linkend="language.operators.comparison">比較演算子</link>
18+
をサポートしています。
19+
</simpara>
20+
21+
<note>
22+
<simpara>
23+
このクラスは、&php.ini;で設定された
24+
<link linkend="ini.bcmath.scale">bcmath.scale</link>
25+
INI ディレクティブの影響を受けません。
26+
</simpara>
27+
</note>
28+
29+
<note>
30+
<simpara>
31+
オーバーロードされた演算子の動作は、対応するメソッドで
32+
<parameter>scale</parameter> パラメータに &null; を指定した場合と同じです。
33+
</simpara>
34+
</note>
35+
</section>
36+
37+
<section xml:id="bcmath-number.synopsis">
38+
&reftitle.classsynopsis;
39+
40+
<classsynopsis class="class">
41+
<ooclass>
42+
<modifier>final</modifier>
43+
<modifier>readonly</modifier>
44+
<classname>BcMath\Number</classname>
45+
</ooclass>
46+
47+
<oointerface>
48+
<modifier>implements</modifier>
49+
<interfacename>Stringable</interfacename>
50+
</oointerface>
51+
52+
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
53+
<fieldsynopsis>
54+
<modifier>public</modifier>
55+
<type>string</type>
56+
<varname linkend="bcmath-number.props.value">value</varname>
57+
</fieldsynopsis>
58+
<fieldsynopsis>
59+
<modifier>public</modifier>
60+
<type>int</type>
61+
<varname linkend="bcmath-number.props.scale">scale</varname>
62+
</fieldsynopsis>
63+
64+
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
65+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.bcmath-number')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='BcMath\\Number'])">
66+
<xi:fallback/>
67+
</xi:include>
68+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.bcmath-number')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='BcMath\\Number'])">
69+
<xi:fallback/>
70+
</xi:include>
71+
</classsynopsis>
72+
</section>
73+
74+
<section xml:id="bcmath-number.props">
75+
&reftitle.properties;
76+
<variablelist>
77+
<varlistentry xml:id="bcmath-number.props.value">
78+
<term><varname>value</varname></term>
79+
<listitem>
80+
<simpara>
81+
任意精度数値の文字表現。
82+
</simpara>
83+
</listitem>
84+
</varlistentry>
85+
<varlistentry xml:id="bcmath-number.props.scale">
86+
<term><varname>scale</varname></term>
87+
<listitem>
88+
<simpara>
89+
オブジェクトに設定されているスケールの値。
90+
計算メソッドで明示的に <parameter>scale</parameter> パラメータが設定されていない場合、
91+
この値は自動的に計算されて設定されます。
92+
</simpara>
93+
</listitem>
94+
</varlistentry>
95+
</variablelist>
96+
</section>
97+
98+
</partintro>
99+
100+
&reference.bc.bcmath.entities.number;
101+
102+
</reference>
103+
<!-- Keep this comment at the end of the file
104+
Local variables:
105+
mode: sgml
106+
sgml-omittag:t
107+
sgml-shorttag:t
108+
sgml-minimize-attributes:nil
109+
sgml-always-quote-attributes:t
110+
sgml-indent-step:1
111+
sgml-indent-data:t
112+
indent-tabs-mode:nil
113+
sgml-parent-document:nil
114+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
115+
sgml-exposed-tags:nil
116+
sgml-local-catalogs:nil
117+
sgml-local-ecat-files:nil
118+
End:
119+
vim600: syn=xml fen fdm=syntax fdl=2 si
120+
vim: et tw=78 syn=sgml
121+
vi: ts=1 sw=1
122+
-->

‎reference/bc/bcmath/number/add.xml

Lines changed: 195 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,195 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: saki Status: ready -->
4+
5+
<refentry xml:id="bcmath-number.add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
6+
<refnamediv>
7+
<refname>BcMath\Number::add</refname>
8+
<refpurpose>任意精度の数値を加算する</refpurpose>
9+
</refnamediv>
10+
11+
<refsect1 role="description">
12+
&reftitle.description;
13+
<methodsynopsis role="BcMath\\Number">
14+
<modifier>public</modifier> <type>BcMath\Number</type><methodname>BcMath\Number::add</methodname>
15+
<methodparam><type class="union"><type>BcMath\Number</type><type>string</type><type>int</type></type><parameter>num</parameter></methodparam>
16+
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
17+
</methodsynopsis>
18+
<simpara>
19+
<varname>$this</varname> と <parameter>num</parameter> を加算します。
20+
</simpara>
21+
</refsect1>
22+
23+
<refsect1 role="parameters">
24+
&reftitle.parameters;
25+
<variablelist>
26+
<varlistentry>
27+
<term><parameter>num</parameter></term>
28+
<listitem>
29+
<simpara>
30+
加数を表す値。
31+
</simpara>
32+
</listitem>
33+
</varlistentry>
34+
<varlistentry>
35+
<term><parameter>scale</parameter></term>
36+
<listitem>
37+
<simpara>
38+
計算結果オブジェクトの <property>BcMath\Number::scale</property> を明示的に指定します。
39+
&null; の場合、計算結果の <property>BcMath\Number::scale</property> は自動的に設定されます。
40+
</simpara>
41+
</listitem>
42+
</varlistentry>
43+
</variablelist>
44+
</refsect1>
45+
46+
<refsect1 role="returnvalues">
47+
&reftitle.returnvalues;
48+
<simpara>
49+
加算結果を新しい <classname>BcMath\Number</classname> オブジェクトとして返します。
50+
</simpara>
51+
<simpara>
52+
加算結果オブジェクトの <property>BcMath\Number::scale</property> が自動的に設定される場合、加算に使用する2つの数値のうち、
53+
大きい方の <property>BcMath\Number::scale</property> が使用されます。
54+
</simpara>
55+
<simpara>
56+
つまり、2つの値の <property>BcMath\Number::scale</property> がそれぞれ <literal>2</literal> と <literal>5</literal> の場合、
57+
加算結果オブジェクトの <property>BcMath\Number::scale</property> は <literal>5</literal> になります。
58+
</simpara>
59+
</refsect1>
60+
61+
<refsect1 role="errors">
62+
&reftitle.errors;
63+
<para>
64+
このメソッドは、以下の場合に <classname>ValueError</classname> をスローします:
65+
<simplelist>
66+
<member><parameter>num</parameter> が、BCMath で有効でない数値形式の文字列である場合</member>
67+
<member><parameter>scale</parameter> が範囲外の値である場合</member>
68+
</simplelist>
69+
</para>
70+
</refsect1>
71+
72+
<refsect1 role="examples">
73+
&reftitle.examples;
74+
<example>
75+
<title><methodname>BcMath\Number::add</methodname> で <parameter>scale</parameter> を指定しない例</title>
76+
<programlisting role="php">
77+
<![CDATA[
78+
<?php
79+
$number = new BcMath\Number('1.234');
80+
81+
$ret1 = $number->add(new BcMath\Number('2.34567'));
82+
$ret2 = $number->add('-3.456');
83+
$ret3 = $number->add(7);
84+
85+
var_dump($number, $ret1, $ret2, $ret3);
86+
?>
87+
]]>
88+
</programlisting>
89+
&example.outputs;
90+
<screen>
91+
<![CDATA[
92+
object(BcMath\Number)#1 (2) {
93+
["value"]=>
94+
string(5) "1.234"
95+
["scale"]=>
96+
int(3)
97+
}
98+
object(BcMath\Number)#3 (2) {
99+
["value"]=>
100+
string(7) "3.57967"
101+
["scale"]=>
102+
int(5)
103+
}
104+
object(BcMath\Number)#2 (2) {
105+
["value"]=>
106+
string(6) "-2.222"
107+
["scale"]=>
108+
int(3)
109+
}
110+
object(BcMath\Number)#4 (2) {
111+
["value"]=>
112+
string(5) "8.234"
113+
["scale"]=>
114+
int(3)
115+
}
116+
]]>
117+
</screen>
118+
</example>
119+
120+
<example>
121+
<title><methodname>BcMath\Number::add</methodname> で <parameter>scale</parameter> を指定する例</title>
122+
<programlisting role="php">
123+
<![CDATA[
124+
<?php
125+
$number = new BcMath\Number('1.234');
126+
127+
$ret1 = $number->add(new BcMath\Number('2.34567'), 1);
128+
$ret2 = $number->add('-3.456', 10);
129+
$ret3 = $number->add(7, 0);
130+
131+
var_dump($number, $ret1, $ret2, $ret3);
132+
?>
133+
]]>
134+
</programlisting>
135+
&example.outputs;
136+
<screen>
137+
<![CDATA[
138+
object(BcMath\Number)#1 (2) {
139+
["value"]=>
140+
string(5) "1.234"
141+
["scale"]=>
142+
int(3)
143+
}
144+
object(BcMath\Number)#3 (2) {
145+
["value"]=>
146+
string(3) "3.5"
147+
["scale"]=>
148+
int(1)
149+
}
150+
object(BcMath\Number)#2 (2) {
151+
["value"]=>
152+
string(13) "-2.2220000000"
153+
["scale"]=>
154+
int(10)
155+
}
156+
object(BcMath\Number)#4 (2) {
157+
["value"]=>
158+
string(1) "8"
159+
["scale"]=>
160+
int(0)
161+
}
162+
]]>
163+
</screen>
164+
</example>
165+
</refsect1>
166+
167+
<refsect1 role="seealso">
168+
&reftitle.seealso;
169+
<simplelist>
170+
<member><function>bcadd</function></member>
171+
<member><methodname>BcMath\Number::sub</methodname></member>
172+
</simplelist>
173+
</refsect1>
174+
175+
</refentry>
176+
<!-- Keep this comment at the end of the file
177+
Local variables:
178+
mode: sgml
179+
sgml-omittag:t
180+
sgml-shorttag:t
181+
sgml-minimize-attributes:nil
182+
sgml-always-quote-attributes:t
183+
sgml-indent-step:1
184+
sgml-indent-data:t
185+
indent-tabs-mode:nil
186+
sgml-parent-document:nil
187+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
188+
sgml-exposed-tags:nil
189+
sgml-local-catalogs:nil
190+
sgml-local-ecat-files:nil
191+
End:
192+
vim600: syn=xml fen fdm=syntax fdl=2 si
193+
vim: et tw=78 syn=sgml
194+
vi: ts=1 sw=1
195+
-->

0 commit comments

Comments
 (0)