PHP array_slice()関数
実例
配列の3番目の要素(インデックスは2)から取り出し、配列の末尾までのすべての要素を返します:
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,2));
例を実行 »
定義と用法
array_slice() 関数は、配列から選択した部分を返します。
注:配列に文字列のキー名がある場合、返される配列はキー名を保持します(例 4 を参照)。
構文
array_slice(array,start,length,preserve)
| パラメータ | 説明 |
|---|---|
| array | 必須。配列を指定します。 |
| start | 必須。数値。要素を取り出す開始位置を指定します。
0 = 最初の要素。
この値が正の場合は、先頭から順に取得します。負の場合は、末尾から start の絶対値の位置から取得します。
-2 は、配列の末尾から2番目の要素から始まることを意味します。 |
| length | 任意。数値。返される配列の長さを指定します。
この値が整数の場合は、その数の要素を返します。負の場合は、配列の終端からその距離の位置で取得を終了します。この値が設定されていない場合は、start パラメータで設定された位置から配列の末尾までを返します。 |
| preserve | 任意。関数がキー名を保持するか、リセットするかを指定します。可能な値:
|
技術詳細
| 戻り値: | 配列から選択した部分を返します。 |
|---|---|
| PHP バージョン: | 4+ |
| 更新ログ: | preserveパラメータは PHP 5.0.2 で追加されました。 |
その他の例
例 1
配列の2番目の要素から取り出し、2つの要素を返します:
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,1,2));
例を実行 »
例 2
負の start パラメータを使う:
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,-2,1));
例を実行 »
例 3
true に設定された preserve パラメータの場合:
//preserve を true に設定すると、キー名が保持されます。
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,1,2,true));
//キー名を保持しない場合は false(デフォルト)に設定します。
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,1,2,false));
//2つの配列のキーが異なることに注意してください。
例を実行 »
例 4
文字列と整数のキー名を指定した場合:
$a=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow","e"=>"brown");
print_r(array_slice($a,1,2));
$a=array("0"=>"red","1"=>"green","2"=>"blue","3"=>"yellow","4"=>"brown");
print_r(array_slice($a,1,2));
例を実行 »
完全な PHP Array リファレンスマニュアル その他の拡張