Skip to content

Commit c1a50d5

Browse files
mumumumumumu
committed
[reference/array] [ext/strings] followed all updates made on or after Oct 1, 2024.
https://github.com/php/doc-en/commits/master/reference/array
1 parent 4773312 commit c1a50d5

27 files changed

+239
-195
lines changed

‎reference/array/book.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa -->
55

6-
<book xml:id="book.array" xmlns="http://docbook.org/ns/docbook">
6+
<book xml:id="book.array" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
77
<?phpdoc extension-membership="core" ?>
88
<title>配列</title>
99

‎reference/array/functions/array-column.xml

Lines changed: 37 additions & 12 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: 8cdc6621f9826d04abc3e50438c010804d7e8683 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 8bf3587d8f70239a65d9aa44d42ced8a696a3e86 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="function.array-column" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -109,31 +109,32 @@
109109
<![CDATA[
110110
<?php
111111
// データベースから返ってきたレコードセットの例
112-
$records = array(
113-
array(
112+
$records = [
113+
[
114114
'id' => 2135,
115115
'first_name' => 'John',
116116
'last_name' => 'Doe',
117-
),
118-
array(
117+
],
118+
[
119119
'id' => 3245,
120120
'first_name' => 'Sally',
121121
'last_name' => 'Smith',
122-
),
123-
array(
122+
],
123+
[
124124
'id' => 5342,
125125
'first_name' => 'Jane',
126126
'last_name' => 'Jones',
127-
),
128-
array(
127+
],
128+
[
129129
'id' => 5623,
130130
'first_name' => 'Peter',
131131
'last_name' => 'Doe',
132-
)
133-
);
132+
]
133+
];
134134
135135
$first_names = array_column($records, 'first_name');
136136
print_r($first_names);
137+
137138
?>
138139
]]>
139140
</programlisting>
@@ -160,8 +161,32 @@ Array
160161
<![CDATA[
161162
<?php
162163
// 先ほどの例と同じ $records 配列を使います
164+
$records = [
165+
[
166+
'id' => 2135,
167+
'first_name' => 'John',
168+
'last_name' => 'Doe',
169+
],
170+
[
171+
'id' => 3245,
172+
'first_name' => 'Sally',
173+
'last_name' => 'Smith',
174+
],
175+
[
176+
'id' => 5342,
177+
'first_name' => 'Jane',
178+
'last_name' => 'Jones',
179+
],
180+
[
181+
'id' => 5623,
182+
'first_name' => 'Peter',
183+
'last_name' => 'Doe',
184+
]
185+
];
186+
163187
$last_names = array_column($records, 'last_name', 'id');
164188
print_r($last_names);
189+
165190
?>
166191
]]>
167192
</programlisting>
@@ -225,7 +250,7 @@ Array
225250
<example>
226251
<title>
227252
オブジェクトの private プロパティ "name" から、マジックメソッド
228-
<function>__get</function> を使って名前を取得する例
253+
<function>__isset</function> と <function>__get</function> を使って名前を取得する例
229254
</title>
230255
<programlisting role="php">
231256
<![CDATA[

‎reference/array/functions/array-combine.xml

Lines changed: 3 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: 71e3c74047f04b26aa1be51215d7129e15dc2993 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xml:id="function.array-combine" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -115,8 +115,8 @@ print_r($c);
115115
<![CDATA[
116116
Array
117117
(
118-
[green] => avocado
119-
[red] => apple
118+
[green] => avocado
119+
[red] => apple
120120
[yellow] => banana
121121
)
122122
]]>

‎reference/array/functions/array-diff.xml

Lines changed: 11 additions & 9 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: c84024092aee02b51dd18b909af0f2ccbdd24f98 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xml:id="function.array-diff" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -104,14 +104,15 @@ Array
104104
</example>
105105
</para>
106106

107+
<para>
108+
<literal>(string) $elem1 === (string) $elem2</literal> の場合のみ、
109+
つまり、<link linkend="language.types.string.casting">文字列表現</link> が同等な場合のみ、
110+
2つの要素は等しいとみなされます。
111+
</para>
112+
107113
<para>
108114
<example>
109115
<title>型が一致しない場合の <function>array_diff</function> の例</title>
110-
<para>
111-
<literal>(string) $elem1 === (string) $elem2</literal> の場合のみ、
112-
つまり、<link linkend="language.types.string.casting">文字列表現</link> が同等な場合のみ、
113-
2つの要素は等しいとみなされます。
114-
</para>
115116
<programlisting role="php">
116117
<![CDATA[
117118
<?php
@@ -139,14 +140,15 @@ $filter = [new S('b'), new S('c'), new S('d')];
139140
$result = array_diff($source, $filter);
140141
141142
// $result には、S('a') のインスタンスが一つ含まれます。
143+
var_dump($result);
142144
?>
143145
]]>
144146
</programlisting>
145-
<para>
146-
別の比較関数を使いたい場合は、<function>array_udiff</function> を参照ください。
147-
</para>
148147
</example>
149148
</para>
149+
<para>
150+
別の比較関数を使いたい場合は、<function>array_udiff</function> を参照ください。
151+
</para>
150152
</refsect1>
151153

152154
<refsect1 role="notes">

‎reference/array/functions/array-fill.xml

Lines changed: 6 additions & 7 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: ce882c196dce81bf6bd4d94af4fa4110ddc49ef4 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: hirokawa Status: ready -->
44
<refentry xml:id="function.array-fill" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>array_fill</refname>
@@ -143,8 +143,7 @@ Array
143143
</para>
144144
<para>
145145
<example xml:id="function.array-fill.example.negative-start-index">
146-
<title>最初のインデックスが負の場合の、<function>array_fill</function>
147-
の例</title>
146+
<title>最初のインデックスが負の場合の、<function>array_fill</function> の例</title>
148147
<programlisting role="php">
149148
<![CDATA[
150149
<?php
@@ -153,27 +152,27 @@ print_r($a);
153152
?>
154153
]]>
155154
</programlisting>
156-
&example.outputs.7;
155+
&example.outputs.8;
157156
<screen>
158157
<![CDATA[
159158
Array
160159
(
161160
[-2] => pear
161+
[-1] => pear
162162
[0] => pear
163163
[1] => pear
164-
[2] => pear
165164
)
166165
]]>
167166
</screen>
168-
&example.outputs.8;
167+
&example.outputs.7;
169168
<screen>
170169
<![CDATA[
171170
Array
172171
(
173172
[-2] => pear
174-
[-1] => pear
175173
[0] => pear
176174
[1] => pear
175+
[2] => pear
177176
)
178177
]]>
179178
</screen>

‎reference/array/functions/array-filter.xml

Lines changed: 1 addition & 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: 1de7b5b65f959de3babdd8ea1b060f8cebd60856 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<refentry xml:id="function.array-filter" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>

‎reference/array/functions/array-is-list.xml

Lines changed: 9 additions & 9 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: 5ecd5e8e50f0f47dce7341ddc95334af62d9e770 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: mumumu Status: ready -->
44
<refentry xml:id="function.array-is-list" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>array_is_list</refname>
@@ -53,22 +53,22 @@
5353
<programlisting role="php">
5454
<![CDATA[
5555
<?php
56-
57-
array_is_list([]); // true
58-
array_is_list(['apple', 2, 3]); // true
59-
array_is_list([0 => 'apple', 'orange']); // true
56+
var_dump(array_is_list([])); // true
57+
var_dump(array_is_list(['apple', 2, 3])); // true
58+
var_dump(array_is_list([0 => 'apple', 'orange'])); // true
6059
6160
// 配列が 0 から始まっていない場合
62-
array_is_list([1 => 'apple', 'orange']); // false
61+
var_dump(array_is_list([1 => 'apple', 'orange'])); // false
6362
6463
// キーの順序が正しくない場合
65-
array_is_list([1 => 'apple', 0 => 'orange']); // false
64+
var_dump(array_is_list([1 => 'apple', 0 => 'orange'])); // false
6665
6766
// キーが数値でない場合
68-
array_is_list([0 => 'apple', 'foo' => 'bar']); // false
67+
var_dump(array_is_list([0 => 'apple', 'foo' => 'bar'])); // false
6968
69+
// Non-consecutive keys
7070
// 数値のキーが連続していない場合
71-
array_is_list([0 => 'apple', 2 => 'bar']); // false
71+
var_dump(array_is_list([0 => 'apple', 2 => 'bar'])); // false
7272
?>
7373
]]>
7474
</programlisting>

‎reference/array/functions/array-key-exists.xml

Lines changed: 38 additions & 30 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: 89fe795cc8bcf1b5ff9eb894bff51f006db66a65 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 73048c75fbe328342b74f0ffb0a0c85c477f5cde Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xml:id="function.array-key-exists" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -74,16 +74,32 @@
7474
<entry>8.0.0</entry>
7575
<entry>
7676
<parameter>key</parameter> パラメータは
77-
<parameter>bool</parameter>, <parameter>float</parameter>, <parameter>int</parameter>,
78-
<parameter>null</parameter>, <parameter>resource</parameter>,
79-
<parameter>string</parameter> を引数として受け入れるようになりました。
77+
<type>bool</type>, <type>float</type>, <type>int</type>,
78+
<type>null</type>, <type>resource</type>, and
79+
<type>string</type> を引数として受け入れるようになりました。
80+
</entry>
81+
</row>
82+
<row>
83+
<entry>8.0.0</entry>
84+
<entry>
85+
<parameter>array</parameter> に <type>object</type> を渡すことは、
86+
サポートされなくなりました。
87+
</entry>
88+
</row>
89+
<row>
90+
<entry>7.4.0</entry>
91+
<entry>
92+
<parameter>array</parameter> に <type>object</type> を渡すことは、
93+
推奨されなくなりました。
94+
<function>property_exists</function> を代わりに使ってください。
8095
</entry>
8196
</row>
8297
</tbody>
8398
</tgroup>
8499
</informaltable>
85100
</refsect1>
86101

102+
87103
<refsect1 role="examples">
88104
&reftitle.examples;
89105
<para>
@@ -92,13 +108,17 @@
92108
<programlisting role="php">
93109
<![CDATA[
94110
<?php
95-
$search_array = array('first' => 1, 'second' => 4);
96-
if (array_key_exists('first', $search_array)) {
97-
echo "この配列には 'first' という要素が存在します";
98-
}
111+
$searchArray = ['first' => 1, 'second' => 4];
112+
var_dump(array_key_exists('first', $searchArray));
99113
?>
100114
]]>
101115
</programlisting>
116+
&example.outputs;
117+
<screen>
118+
<![CDATA[
119+
bool(true)
120+
]]>
121+
</screen>
102122
</example>
103123
</para>
104124
<example>
@@ -111,35 +131,23 @@ if (array_key_exists('first', $search_array)) {
111131
<programlisting role="php">
112132
<![CDATA[
113133
<?php
114-
$search_array = array('first' => null, 'second' => 4);
115-
116-
// false を返します
117-
isset($search_array['first']);
134+
$searchArray = ['first' => null, 'second' => 4];
118135
119-
// true を返します
120-
array_key_exists('first', $search_array);
136+
var_dump(isset($searchArray['first']));
137+
var_dump(array_key_exists('first', $searchArray));
121138
?>
122139
]]>
123140
</programlisting>
141+
&example.outputs;
142+
<screen>
143+
<![CDATA[
144+
bool(false)
145+
bool(true)
146+
]]>
147+
</screen>
124148
</example>
125149
</refsect1>
126150

127-
<refsect1 role="notes">
128-
&reftitle.notes;
129-
<note>
130-
<para>
131-
過去との互換性を保つため、<parameter>key</parameter>
132-
が仮に <parameter>array</parameter> で指定したオブジェクトのプロパティであっても
133-
<function>array_key_exists</function> は &true; を返します。
134-
この挙動は PHP 7.4.0 で非推奨となり、PHP 8.0.0 以降で削除されています。
135-
</para>
136-
<para>
137-
オブジェクトのプロパティが存在するかどうかを調べるには、
138-
<function>property_exists</function> を使いましょう。
139-
</para>
140-
</note>
141-
</refsect1>
142-
143151
<refsect1 role="seealso">
144152
&reftitle.seealso;
145153
<para>

‎reference/array/functions/array-map.xml

Lines changed: 2 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: 33968dfebb9b847733d02ee221b3b8054a101b41 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 2e60c5134e7a847c99f81eb3f7ecee1f5efeeace Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,mumumu -->
55
<refentry xml:id="function.array-map" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -155,6 +155,7 @@ print_r(array_map(fn($value): int => $value * 2, range(1, 5)));
155155
?>
156156
]]>
157157
</programlisting>
158+
&example.outputs;
158159
<screen>
159160
<![CDATA[
160161
Array

0 commit comments

Comments
 (0)