array

説明

array array ( [mixed ...])

パラメータの配列を返します。パラメータには、 =>演算子によりインデックスを指定することもできます。配列に関するより詳しい情報は配列型のセクションをご覧ください。

注意: array()は、実際にはリテラル配列を表現するための言語構成要素であり、通常の関数ではありません。

カンマ区切った構文 "index => values" は、インデックスと値を定義します。インデックスは文字列または数値とすることが可能です。インデックスが省略された場合、0から始まる整数インデックスが自動的に生成されます。インデックスが整数の場合、次に生成されるインデックスは、整数インデックスの最大値 + 1 となります。同じインデックスを 2度定義した場合、後の定義により最初の定義が上書きされることに注意して下さい。

以下の例では、2 次元配列の生成方法、連想配列のキーの指定方法、および通常の配列において添字番号をスキップし、それに続く要素にアクセスする方法についてご紹介しています。
例 1. array()の例
<?php $fruits = array ( "fruits" => array ("a"=>"orange", "b"=>"banana", "c"=>"apple"), "numbers" => array (1, 2, 3, 4, 5, 6), "holes" => array ("first", 5 => "second", "third") ) ?>

例 2. array() における自動インデックス
<?php $array = array( 1, 1, 1, 1, 1, 8=>1, 4=>1, 19, 3=>13); print_r($array); ?>
この例の出力は次のようになります。
Array ( [0] => 1 [1] => 1 [2] => 1 [3] => 13 [4] => 1 [8] => 1 [9] => 19 )

インデックス '3' は二度定義されており、後の値 13 が保持されることに注意して下さい。インデックス 4 はインデックス 8 の後に定義され、次に生成されるインデックス(値は19)は、最大のインデックスが 8 であるため、9となります。

次の例は、1から始まる配列を作成します。
例 3. array() で1から始まる配列を作成
<?php $firstquarter = array(1 => 'January', 'February', 'March'); print_r($firstquarter); ?>
この例の出力は次のようになります。
Array ( [1] => 'January' [2] => 'February' [3] => 'March' )

array_pad(), list(), foreach, range()も参照してください。