array_slice
(PHP 4, PHP 5)
array_slice -- 配列の一部を展開する
説明
array
array_slice ( array array, int offset [, int length [, bool preserve_keys]] )
array_slice()は、array
から引数 offset および
length で指定された連続する要素を返します。
offset が負の値ではない場合、要素位置の計算は、
配列 array の offset から始められます。
offset が負の場合、要素位置の計算は
array の最後から行われます。
lengthが指定され、正の場合、
連続する複数の要素が返されます。length
が指定され、負の場合、配列の末尾から連続する複数の要素が返されます。
省略された場合、offset
から配列の最後までの全ての要素が返されます。
array_slice() はデフォルトで配列の数値キーを
リセットすることに注意してください。PHP 5.0.2 からは、
preserve_keys を TRUE
にする事でこの動作を変更することができます。
例 1. array_slice() の例
<?php
$input = array("a", "b", "c", "d", "e");
$output = array_slice($input, 2); // "c", "d", "e" を返す
$output = array_slice($input, -2, 1); // "d" を返す
$output = array_slice($input, 0, 3); // "a", "b", "c" を返す
// 配列キーの違いに注意
print_r(array_slice($input, 2, -1));
print_r(array_slice($input, 2, -1, true));
?>
|
上の例の出力は以下となります。 Array
(
[0] => c
[1] => d
)
Array
(
[2] => c
[3] => d
) |
|
array_splice() および
unset() も参照ください。