reference/array/functions/array-splice.xml
cd943f94a013b74df8765ab8e1a620a916a64a85
...
...
@@ -9,20 +9,20 @@
9
9
&reftitle.description;
10
10
<methodsynopsis>
11
11
<type>array</type><methodname>array_splice</methodname>
12
-
<methodparam><type>array</type><parameter role="reference">input</parameter></methodparam>
12
+
<methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
13
13
<methodparam><type>int</type><parameter>offset</parameter></methodparam>
14
-
<methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>count($input)</initializer></methodparam>
15
-
<methodparam choice="opt"><type>mixed</type><parameter>replacement</parameter><initializer>array()</initializer></methodparam>
14
+
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
15
+
<methodparam choice="opt"><type>mixed</type><parameter>replacement</parameter><initializer>[]</initializer></methodparam>
16
16
</methodsynopsis>
17
17
<para>
18
18
Removes the elements designated by <parameter>offset</parameter> and
19
-
<parameter>length</parameter> from the <parameter>input</parameter> array,
19
+
<parameter>length</parameter> from the <parameter>array</parameter> array,
20
20
and replaces them with the elements of the
21
21
<parameter>replacement</parameter> array, if supplied.
22
22
</para>
23
23
<note>
24
24
<para>
25
-
Numerical keys in <parameter>input</parameter> are not preserved.
25
+
Numerical keys in <parameter>array</parameter> are not preserved.
26
26
</para>
27
27
</note>
28
28
<note>
...
...
@@ -39,7 +39,7 @@
39
39
<para>
40
40
<variablelist>
41
41
<varlistentry>
42
-
<term><parameter>input</parameter></term>
42
+
<term><parameter>array</parameter></term>
43
43
<listitem>
44
44
<para>
45
45
The input array.
...
...
@@ -52,12 +52,12 @@
52
52
<para>
53
53
If <parameter>offset</parameter> is positive then the start of the
54
54
removed portion is at that offset from the beginning of the
55
-
<parameter>input</parameter> array.
55
+
<parameter>array</parameter> array.
56
56
</para>
57
57
<para>
58
58
If <parameter>offset</parameter> is negative then the start of the
59
59
removed portion is at that offset from the end of the
60
-
<parameter>input</parameter> array.
60
+
<parameter>array</parameter> array.
61
61
</para>
62
62
</listitem>
63
63
</varlistentry>
...
...
@@ -124,6 +124,29 @@
124
124
Returns an array consisting of the extracted elements.
125
125
</para>
126
126
</refsect1>
127
+

128
+
<refsect1 role="changelog">
129
+
&reftitle.changelog;
130
+
<informaltable>
131
+
<tgroup cols="2">
132
+
<thead>
133
+
<row>
134
+
<entry>&Version;</entry>
135
+
<entry>&Description;</entry>
136
+
</row>
137
+
</thead>
138
+
<tbody>
139
+
<row>
140
+
<entry>8.0.0</entry>
141
+
<entry>
142
+
<parameter>length</parameter> is nullable now.
143
+
</entry>
144
+
</row>
145
+
</tbody>
146
+
</tgroup>
147
+
</informaltable>
148
+
</refsect1>
149
+

127
150
<refsect1 role="examples">
128
151
&reftitle.examples;
129
152
<para>
...
...
@@ -234,7 +257,6 @@ array_splice($input, $x, 1, $y);
234
257
</para>
235
258
</refsect1>
236
259
</refentry>
237
-

238
260
<!-- Keep this comment at the end of the file
239
261
Local variables:
240
262
mode: sgml
241
263