array

(PHP 3, PHP 4, PHP 5 )

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()も参照してください。