Skip to content

Commit 4f2e286

Browse files
mumumumumumu
committed
[language/types/*.xml] sync with en
1 parent d836ae2 commit 4f2e286

File tree

9 files changed

+132
-103
lines changed

9 files changed

+132
-103
lines changed

‎language/types/callable.xml

Lines changed: 6 additions & 6 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: c897161ca5a62a887295c695adc161b8fde5d772 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<sect1 xml:id="language.types.callable">
66
<title>コールバック / Callable</title>
@@ -73,13 +73,13 @@
7373
7474
// コールバック関数の例
7575
function my_callback_function() {
76-
echo 'hello world!';
76+
echo 'hello world!', PHP_EOL;
7777
}
7878
7979
// コールバックメソッドの例
8080
class MyClass {
8181
static function myCallbackMethod() {
82-
echo 'Hello World!';
82+
echo 'Hello World!', PHP_EOL;
8383
}
8484
}
8585
@@ -99,13 +99,13 @@ call_user_func('MyClass::myCallbackMethod');
9999
// タイプ 5: 相対指定によるstaticメソッドのコール
100100
class A {
101101
public static function who() {
102-
echo "A\n";
102+
echo 'A', PHP_EOL;
103103
}
104104
}
105105
106106
class B extends A {
107107
public static function who() {
108-
echo "B\n";
108+
echo 'B', PHP_EOL;
109109
}
110110
}
111111
@@ -114,7 +114,7 @@ call_user_func(array('B', 'parent::who')); // A, 但し PHP 8.2.0 以降は非
114114
// タイプ 6: __invoke を実装したオブジェクトを callable として用いる
115115
class C {
116116
public function __invoke($name) {
117-
echo 'Hello ', $name, "\n";
117+
echo 'Hello ', $name, PHP_EOL;
118118
}
119119
}
120120

‎language/types/declarations.xml

Lines changed: 6 additions & 5 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: f908fff129bcd8ec1605658e06457cb04e5b2b51 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: mumumu Status: ready -->
44

55
<sect1 xml:id="language.types.declarations">
66
<title>型宣言</title>
@@ -319,6 +319,7 @@ Stack trace:
319319
これは、子クラスでデフォルト値が変更された場合にクラスの互換性が壊れ、
320320
型宣言で <type>null</type>
321321
型を追加しなければならなくなるため、おすすめできません。
322+
この振る舞いは、PHP 8.4 以降は推奨されなくなっています。
322323
</para>
323324
<example>
324325
<title>引数にnullを許容する古いやり方</title>
@@ -615,7 +616,7 @@ NULL
615616

616617
<example>
617618
<title>Null を許容する戻り値の型宣言</title>
618-
<programlisting role="php">
619+
<programlisting role="php" annotations="non-interactive">
619620
<![CDATA[
620621
<?php
621622
function get_item(): ?string {
@@ -632,7 +633,7 @@ function get_item(): ?string {
632633

633634
<example>
634635
<title>クラスのプロパティで型宣言</title>
635-
<programlisting role="php">
636+
<programlisting role="php" annotations="non-interactive">
636637
<![CDATA[
637638
<?php
638639
class User {
@@ -701,7 +702,7 @@ class User {
701702

702703
<example>
703704
<title>引数の値に対する厳密な型付け</title>
704-
<programlisting role="php">
705+
<programlisting role="php" annotations="non-interactive">
705706
<![CDATA[
706707
<?php
707708
declare(strict_types=1);
@@ -756,7 +757,7 @@ int(3)
756757

757758
<example>
758759
<title>戻り値に対する厳密な型付け</title>
759-
<programlisting role="php">
760+
<programlisting role="php" annotations="non-interactive">
760761
<![CDATA[
761762
<?php
762763
declare(strict_types=1);

‎language/types/float.xml

Lines changed: 13 additions & 11 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: a1e3d629b4f01ee41bd38391cd5c6ae5ee894cb3 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<sect1 xml:id="language.types.float" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>浮動小数点数</title>
@@ -13,8 +13,8 @@
1313
<programlisting role="php">
1414
<![CDATA[
1515
<?php
16-
$a = 1.234;
17-
$b = 1.2e3;
16+
$a = 1.234;
17+
$b = 1.2e3;
1818
$c = 7E-10;
1919
$d = 1_234.567; // PHP 7.4.0 以降
2020
?>
@@ -52,7 +52,7 @@ EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
5252
複雑な算術演算をすると、誤差はさらに大きくなるでしょう。そしてもちろん、
5353
いくつかの演算を組み合わせる場合にも誤差を考慮しなければなりません。
5454
</para>
55-
55+
5656
<para>
5757
さらに、十進数では正確な小数で表せる有理数、たとえば
5858
<literal>0.1</literal> や <literal>0.7</literal> は、
@@ -131,26 +131,28 @@ EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
131131
計算時に扱える最小の差分を表します。
132132
</para>
133133

134-
<informalexample>
135-
<simpara>
136-
<varname>$a</varname> と <varname>$b</varname> は、精度 5 桁では等しくなります。
137-
</simpara>
134+
<para>
135+
<varname>$a</varname> と <varname>$b</varname> は、精度 5 桁では等しくなります。
136+
</para>
137+
138+
<example>
139+
<title>浮動小数点数の比較</title>
138140
<programlisting role="php">
139141
<![CDATA[
140142
<?php
141143
$a = 1.23456789;
142144
$b = 1.23456780;
143145
$epsilon = 0.00001;
144146
145-
if(abs($a-$b) < $epsilon) {
147+
if (abs($a - $b) < $epsilon) {
146148
echo "true";
147149
}
148150
?>
149151
]]>
150152
</programlisting>
151-
</informalexample>
153+
</example>
152154
</sect2>
153-
155+
154156
<sect2 xml:id="language.types.float.nan">
155157
<title>NaN</title>
156158
<para>

‎language/types/integer.xml

Lines changed: 10 additions & 6 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: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<sect1 xml:id="language.types.integer">
66
<title>整数</title>
@@ -48,7 +48,7 @@
4848

4949
<example>
5050
<title>整数リテラル</title>
51-
<programlisting role="php">
51+
<programlisting role="php" annotations="non-interactive">
5252
<![CDATA[
5353
<?php
5454
$a = 1234; // 10進整数
@@ -137,7 +137,8 @@ var_dump(PHP_INT_MAX + 1); // 32-bit system: float(2147483648)
137137
また、<function>round</function> 関数を使用することもできます。
138138
</para>
139139

140-
<informalexample>
140+
<example>
141+
<title>除算の例</title>
141142
<programlisting role="php">
142143
<![CDATA[
143144
<?php
@@ -147,7 +148,7 @@ var_dump(round(25/7)); // float(4)
147148
?>
148149
]]>
149150
</programlisting>
150-
</informalexample>
151+
</example>
151152
</sect2>
152153

153154
<sect2 xml:id="language.types.integer.casting">
@@ -191,7 +192,9 @@ var_dump(round(25/7)); // float(4)
191192
PHP 8.1.0 以降では、精度を損なうことになる &float; から &integer; への暗黙の変換は推奨されなくなり、警告が発生します。
192193
</simpara>
193194

194-
<programlisting role="php">
195+
<example>
196+
<title>float 型からキャストする</title>
197+
<programlisting role="php">
195198
<![CDATA[
196199
<?php
197200
function foo($value): int {
@@ -204,7 +207,8 @@ var_dump((int) 8.1); // PHP 8.1.0 より前でもあとでも、8
204207
var_dump(intval(8.1)); // PHP 8.1.0 より前でもあとでも、8
205208
?>
206209
]]>
207-
</programlisting>
210+
</programlisting>
211+
</example>
208212

209213
<para>
210214
float が整数の範囲 (通常は、32 ビットプラットフォームでは <literal>+/- 2.15e+9 =

‎language/types/iterable.xml

Lines changed: 4 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: 161dde4fe721309398dd324edbf02aec409f127b Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: mumumu Status: ready -->
44
<sect1 xml:id="language.types.iterable">
55
<title>Iterable</title>
66

@@ -37,6 +37,9 @@ function gen(): iterable {
3737
yield 3;
3838
}
3939
40+
foreach(gen() as $value) {
41+
echo $value, "\n";
42+
}
4043
?>
4144
]]>
4245
</programlisting>

‎language/types/numeric-strings.xml

Lines changed: 5 additions & 2 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: 7ba2406e555a240338d63f72d9ac54a46e0bee5d Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: mumumu Status: ready -->
44

55
<sect1 xml:id="language.types.numeric-strings" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>数値形式の文字列</title>
@@ -38,6 +38,9 @@ NUM_STRING ({INT_NUM_STRING} | {FLOAT_NUM_STRING})
3838
文字 <literal>E</literal> (大文字小文字を区別しません) が含まれる文字列のうち、
3939
その文字で数値を区切っている場合、科学的記法で記された数値とみなされます。
4040
この場合、予期しない結果が発生するかもしれません。
41+
</para>
42+
<example>
43+
<title>科学的記法の比較</title>
4144
<programlisting role="php">
4245
<![CDATA[
4346
<?php
@@ -47,7 +50,7 @@ var_dump("2E1" == "020"); // true, "2E1" は 2 * (10 ^ 1), または 20
4750
?>
4851
]]>
4952
</programlisting>
50-
</para>
53+
</example>
5154
</note>
5255

5356
<sect2 xml:id="language.types.numeric-string.conversion">

‎language/types/object.xml

Lines changed: 15 additions & 10 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: 4c4b82965384d55f5c3efb1ffa80615acd98a737 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<sect1 xml:id="language.types.object">
66
<title>オブジェクト</title>
@@ -13,7 +13,8 @@
1313
命令によりオブジェクトのインスタンスを変数に作成します。
1414
</para>
1515

16-
<informalexample>
16+
<example>
17+
<title>オブジェクトの作成</title>
1718
<programlisting role="php">
1819
<![CDATA[
1920
<?php
@@ -30,7 +31,7 @@ $bar->do_foo();
3031
?>
3132
]]>
3233
</programlisting>
33-
</informalexample>
34+
</example>
3435

3536
<simpara>
3637
詳細な事項については、
@@ -52,23 +53,27 @@ $bar->do_foo();
5253
より前のバージョンでは、数値のキーの場合プロパティ名によるアクセスはできなかった点に注意して下さい。
5354
</para>
5455

55-
<informalexample>
56+
<example>
57+
<title>オブジェクトにキャストする</title>
5658
<programlisting role="php">
5759
<![CDATA[
5860
<?php
5961
$obj = (object) array('1' => 'foo');
60-
var_dump(isset($obj->{'1'})); // PHP 7.2.0 以降は 'bool(true)' それより前は 'bool(false)'
61-
var_dump(key($obj)); // PHP 7.2.0 以降は 'string(1) "1"' それより前は 'int(1)'
62+
var_dump(isset($obj->{'1'})); // outputs 'bool(true)'
63+
64+
// PHP 8.1 以降は非推奨
65+
var_dump(key($obj)); // outputs 'string(1) "1"'
6266
?>
6367
]]>
6468
</programlisting>
65-
</informalexample>
69+
</example>
6670

6771
<para>
6872
上記以外の値の場合には、<literal>scalar</literal> という名前のメンバ変数が値を格納します。
6973
</para>
7074

71-
<informalexample>
75+
<example>
76+
<title><literal>(object)</literal> によるキャスト</title>
7277
<programlisting role="php">
7378
<![CDATA[
7479
<?php
@@ -77,11 +82,11 @@ echo $obj->scalar; // 'ciao' を出力します
7782
?>
7883
]]>
7984
</programlisting>
80-
</informalexample>
85+
</example>
8186

8287
</sect2>
8388
</sect1>
84-
89+
8590
<!-- Keep this comment at the end of the file
8691
Local variables:
8792
mode: sgml

0 commit comments

Comments
 (0)