(PHP 4, PHP 5, PHP 7, PHP 8)
array — 新建一個(gè)數(shù)組
創(chuàng)建一個(gè)數(shù)組。關(guān)于數(shù)組是什么的信息請(qǐng)閱讀數(shù)組一節(jié)。
values語(yǔ)法“index => values”，用逗號(hào)分開(kāi)，定義了索引和值。索引可以是字符串或數(shù)字。如果省略了索引，會(huì)自動(dòng)產(chǎn)生從 0 開(kāi)始的整數(shù)索引。如果索引是整數(shù)，則下一個(gè)產(chǎn)生的索引將是目前最大的整數(shù)索引 + 1。注意如果定義了兩個(gè)完全一樣的索引，則后面一個(gè)會(huì)覆蓋前一個(gè)。
在最后一個(gè)定義的數(shù)組項(xiàng)目之后加一個(gè)逗號(hào)雖然不常見(jiàn)，卻是合法的語(yǔ)法。
返回根據(jù)參數(shù)建立的數(shù)組。參數(shù)可以用 =>
運(yùn)算符給出索引。關(guān)于數(shù)組是什么的信息請(qǐng)閱讀數(shù)組一節(jié)。
下面的例子演示了怎樣建立一個(gè)二維數(shù)組，怎樣給相應(yīng)的數(shù)組指定鍵名，以及怎樣在普通數(shù)組中略過(guò)和繼續(xù)數(shù)字索引。
示例 #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() 的自動(dòng)索引
<?php
$array = array(1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13);
print_r($array);
?>
以上例程會(huì)輸出：
Array
(
[0] => 1
[1] => 1
[2] => 1
[3] => 13
[4] => 1
[8] => 1
[9] => 19
)
注意索引 3 被定義了兩次，保留了最后的值 13。索引 4 在 索引 8 之后定義，下一個(gè)自動(dòng)生成的索引（值為 19 那個(gè)）為 9，因?yàn)樽畲蟮乃饕?8。
本例建立了從 1 開(kāi)始的數(shù)組。
示例 #3 從 1 開(kāi)始索引的 array()
<?php
$firstquarter = array(1 => 'January', 'February', 'March');
print_r($firstquarter);
?>
以上例程會(huì)輸出：
Array
(
[1] => January
[2] => February
[3] => March
)
在 Perl 中，可以訪問(wèn)在雙引號(hào)內(nèi)的數(shù)組的值。但在 PHP 中需要將數(shù)組用花括號(hào)括起來(lái)。
示例 #4 訪問(wèn)雙引號(hào)內(nèi)的數(shù)組
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>
注意:
array() 是一個(gè)語(yǔ)言結(jié)構(gòu)，用于字面上表示數(shù)組，不是常規(guī)的函數(shù)。