説明

array(mixed ...$values): array

配列を作成します。角括弧を使った記法([]) も含めた、配列に関するより詳しい情報は配列型のセクションをご覧ください。

パラメータ

values

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

一般的ではありませんが、最後に定義された配列エントリの後に続くカンマがある場合、これは有効な構文です。

戻り値

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

例

以下の例では、二次元配列の生成方法、連想配列のキーの指定方法、および通常の配列において添字番号をスキップし、それに続く要素にアクセスする方法について紹介しています。

例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")
);
print_r($fruits);
?>

例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
)

Perl では、ダブルクオートで囲まれた配列の値にアクセスすることができます。しかしながら、PHP では配列を中括弧で囲む必要があります。

例4 ダブルクオートで囲まれた配列にアクセスする

<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>

注意

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

参考

array_pad() - 指定長、指定した値で配列を埋める
list() - 配列と同様の形式で、複数の変数への代入を行う
count() - 配列または Countable オブジェクトに含まれるすべての要素の数を数える
range() - ある範囲の要素を含む配列を作成する
foreach
array 型