reference/array/functions/array-column.xml
8cdc6621f9826d04abc3e50438c010804d7e8683
...
...
@@ -9,13 +9,13 @@
9
9
&reftitle.description;
10
10
<methodsynopsis>
11
11
<type>array</type><methodname>array_column</methodname>
12
-
<methodparam><type>array</type><parameter>input</parameter></methodparam>
13
-
<methodparam><type>mixed</type><parameter>column_key</parameter></methodparam>
14
-
<methodparam choice="opt"><type>mixed</type><parameter>index_key</parameter><initializer>&null;</initializer></methodparam>
12
+
<methodparam><type>array</type><parameter>array</parameter></methodparam>
13
+
<methodparam><type class="union"><type>int</type><type>string</type><type>null</type></type><parameter>column_key</parameter></methodparam>
14
+
<methodparam choice="opt"><type class="union"><type>int</type><type>string</type><type>null</type></type><parameter>index_key</parameter><initializer>&null;</initializer></methodparam>
15
15
</methodsynopsis>
16
16
<para>
17
17
<function>array_column</function> returns the values from a single column of
18
-
the <parameter>input</parameter>, identified by the
18
+
the <parameter>array</parameter>, identified by the
19
19
<parameter>column_key</parameter>. Optionally, an
20
20
<parameter>index_key</parameter> may be provided to index the values in the
21
21
returned array by the values from the <parameter>index_key</parameter>
...
...
@@ -27,7 +27,7 @@
27
27
<para>
28
28
<variablelist>
29
29
<varlistentry>
30
-
<term><parameter>input</parameter></term>
30
+
<term><parameter>array</parameter></term>
31
31
<listitem>
32
32
<para>
33
33
A multi-dimensional array or an array of objects from which to pull a
...
...
@@ -58,8 +58,8 @@
58
58
The column to use as the index/keys for the returned array. This value
59
59
may be the integer key of the column, or it may be the string key name.
60
60
The value is <link linkend="language.types.array.key-casts">cast</link>
61
-
as usual for array keys (however, objects supporting conversion to string
62
-
are also allowed).
61
+
as usual for array keys (however, prior to PHP 8.0.0, objects supporting
62
+
conversion to string were also allowed).
63
63
</para>
64
64
</listitem>
65
65
</varlistentry>
...
...
@@ -85,10 +85,10 @@
85
85
</thead>
86
86
<tbody>
87
87
<row>
88
-
<entry>7.0.0</entry>
88
+
<entry>8.0.0</entry>
89
89
<entry>
90
-
Added the ability for the <parameter>input</parameter> parameter to be
91
-
an array of objects.
90
+
Objects in columns indicated by <parameter>index_key</parameter> parameter
91
+
will no longer be cast to string and will now throw a <classname>TypeError</classname> instead.
92
92
</entry>
93
93
</row>
94
94
</tbody>
...
...
@@ -275,20 +275,7 @@ Array
275
275
</para>
276
276
</refsect1>
277
277

278
-
<refsect1 role="seealso">
279
-
&reftitle.seealso;
280
-
<para>
281
-
<simplelist>
282
-
<member>
283
-
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.arraycolumn.compat;">Recommended
284
-
userland implementation for PHP lower than 5.5</link>
285
-
</member>
286
-
</simplelist>
287
-
</para>
288
-
</refsect1>
289
-

290
278
</refentry>
291
-

292
279
<!-- Keep this comment at the end of the file
293
280
Local variables:
294
281
mode: sgml
295
282