array_slice
Extract a slice of the array
&reftitle.description;
arrayarray_slice
arrayarray
intoffset
intnulllength&null;
boolpreserve_keys&false;
array_slice returns the sequence of elements
from the array array as specified by the
offset and length
parameters.
&reftitle.parameters;
array
The input array.
offset
If offset is non-negative, the sequence will
start at that offset in the array.
If offset is negative, the sequence will
start that far from the end of the array.
The offset parameter denotes the position
in the array, not the key.
length
If length is given and is positive,
then the sequence will have up to that many elements in it.
If the array is shorter than the length,
then only the available array elements will be present.
If length is given and is negative then the
sequence will stop that many elements from the end of the array.
If it is omitted, then the sequence will have everything
from offset up until the end of the
array.
preserve_keys
array_slice will reorder and reset the
integer array indices by default. This behaviour can be changed
by setting preserve_keys to &true;.
String keys are always preserved, regardless of this parameter.
&reftitle.returnvalues;
Returns the slice. If the offset is larger than the size of the array,
an empty array is returned.
&reftitle.examples;
<function>array_slice</function> examples
]]>
&example.outputs;
c
[1] => d
)
Array
(
[2] => c
[3] => d
)
]]>
<function>array_slice</function> and one-based array
"a", "b", "c", "d", "e");
print_r(array_slice($input, 1, 2));
?>
]]>
&example.outputs;
b
[1] => c
)
]]>
<function>array_slice</function> and array with mixed keys
'apple', 'b'=>'banana', '42'=>'pear', 'd'=>'orange');
print_r(array_slice($ar, 0, 3));
print_r(array_slice($ar, 0, 3, true));
?>
]]>
&example.outputs;
apple
[b] => banana
[0] => pear
)
Array
(
[a] => apple
[b] => banana
[42] => pear
)
]]>
&reftitle.seealso;
array_chunk
array_splice
unset