PHP 中的數組實際上是一個有序映射。映射是一種把 values 關聯到 keys 的類型。此類型在很多方面做了最佳化,因此可以把它當成真正的數組,或列表(向量),散列表(是映射的一種實現),字典,集合,棧,隊列以及更多可能性。由於數組元素的值也可以是另一個數組,樹形結構和多維陣列也是允許的。
array
(PHP 4, PHP 5)
array — 建立一個數組
說明
複製代碼 代碼如下:
array array ([ mixed $... ] )
返回根據參數建立的數組。參數可以用 => 運算子給出索引。關於數組是什麼的資訊請閱讀數組一節。
Note:
array() 是一個語言結構,用於字面上表示數組,不是常規的函數。
文法“index => values”,用逗號分開,定義了索引和值。索引可以是字串或數字。如果省略了索引,會自動產生從 0 開始的整數索引。如果索引是整數,則下一個產生的索引將是目前最大的整數索引 + 1。注意如果定義了兩個完全一樣的索引,則後面一個會覆蓋前一個。
在最後一個定義的數組項目之後加一個逗號雖然不常見,卻是合法的文法。
下面的例子示範了怎樣建立一個二維數組,怎樣給相應的數組指定鍵名,以及怎樣在普通數組中略過和繼續數字索引。
Example #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"));?>
Example #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 那個)為 9,因為最大的索引是 8。
本例建立了從 1 開始的數組。
Example #3 從 1 開始索引的 array()
<?php$firstquarter = array(1 => 'January', 'February', 'March');print_r($firstquarter);?>
以上常式會輸出:
Array( [1] => January [2] => February [3] => March)
在 Perl 中,可以訪問在雙引號內的數組的值。但在 PHP 中需要將數組用花括弧括起來。
Example #4 訪問雙引號內的數組
<?php$foo = array('bar' => 'baz');echo "Hello {$foo['bar']}!"; // Hello baz!?>
PHP Array 函數
PHP:指示支援該函數的最早的 PHP 版本。
| 函數 |
描述 |
PHP |
| array() |
建立數組。 |
3 |
| array_change_key_case() |
返回其鍵均為大寫或小寫數組。 |
4 |
| array_chunk() |
把一個數組分割為新的數組塊。 |
4 |
| array_combine() |
通過合并兩個數組來建立一個新數組。 |
5 |
| array_count_values() |
用於統計數組中所有值出現的次數。 |
4 |
| array_diff() |
返回兩個數組的差集數組。 |
4 |
| array_diff_assoc() |
比較鍵名和索引值,並返回兩個數組的差集數組。 |
4 |
| array_diff_key() |
比較鍵名,並返回兩個數組的差集數組。 |
5 |
| array_diff_uassoc() |
通過使用者提供的回呼函數做索引檢查來計算數組的差集。 |
5 |
| array_diff_ukey() |
用回呼函數對鍵名比較計算數組的差集。 |
5 |
| array_fill() |
用給定的值填充數組。 |
4 |
| array_filter() |
用回呼函數過濾數組中的元素。 |
4 |
| array_flip() |
交換數組中的鍵和值。 |
4 |
| array_intersect() |
計算數組的交集。 |
4 |
| array_intersect_assoc() |
比較鍵名和索引值,並返回兩個數組的交集數組。 |
4 |
| array_intersect_key() |
使用鍵名比較計算數組的交集。 |
5 |
| array_intersect_uassoc() |
帶索引檢查計算數組的交集,用回呼函數比較索引。 |
5 |
| array_intersect_ukey() |
用回呼函數比較鍵名來計算數組的交集。 |
5 |
| array_key_exists() |
檢查給定的鍵名或索引是否存在於數組中。 |
4 |
| array_keys() |
返回數組中所有的鍵名。 |
4 |
| array_map() |
將回呼函數作用到給定數組的單元上。 |
4 |
| array_merge() |
把一個或多個數組合并為一個數組。 |
4 |
| array_merge_recursive() |
遞迴地合并一個或多個數組。 |
4 |
| array_multisort() |
對多個數組或多維陣列進行排序。 |
4 |
| array_pad() |
用值將數組填補到指定長度。 |
4 |
| array_pop() |
將數組最後一個單元彈出(出棧)。 |
4 |
| array_product() |
計算數組中所有值的乘積。 |
5 |
| array_push() |
將一個或多個單元(元素)壓入數組的末尾(入棧)。 |
4 |
| array_rand() |
從數組中隨機選出一個或多個元素,並返回。 |
4 |
| array_reduce() |
用回呼函數迭代地將數組簡化為單一的值。 |
4 |
| array_reverse() |
將原數組中的元素順序翻轉,建立新的數組並返回。 |
4 |
| array_search() |
在數組中搜尋給定的值,如果成功則返回相應的鍵名。 |
4 |
| array_shift() |
刪除數組中的第一個元素,並返回被刪除元素的值。 |
4 |
| array_slice() |
在數組中根據條件取出一段值,並返回。 |
4 |
| array_splice() |
把數組中的一部分去掉並用其它值取代。 |
4 |
| array_sum() |
計算數組中所有值的和。 |
4 |
| array_udiff() |
用回呼函數比較資料來計算數組的差集。 |
5 |
| array_udiff_assoc() |
帶索引檢查計算數組的差集,用回呼函數比較資料。 |
5 |
| array_udiff_uassoc() |
帶索引檢查計算數組的差集,用回呼函數比較資料和索引。 |
5 |
| array_uintersect() |
計算數組的交集,用回呼函數比較資料。 |
5 |
| array_uintersect_assoc() |
帶索引檢查計算數組的交集,用回呼函數比較資料。 |
5 |
| array_uintersect_uassoc() |
帶索引檢查計算數組的交集,用回呼函數比較資料和索引。 |
5 |
| array_unique() |
刪除數組中重複的值。 |
4 |
| array_unshift() |
在數組開頭插入一個或多個元素。 |
4 |
| array_values() |
返回數組中所有的值。 |
4 |
| array_walk() |
對數組中的每個成員應用使用者函數。 |
3 |
| array_walk_recursive() |
對數組中的每個成員遞迴地應用使用者函數。 |
5 |
| arsort() |
對數組進行逆向排序並保持索引關係。 |
3 |
| asort() |
對數組進行排序並保持索引關係。 |
3 |
| compact() |
建立一個數組,包括變數名和它們的值。 |
4 |
| count() |
計算數組中的元素數目或對象中的屬性個數。 |
3 |
| current() |
返回數組中的當前元素。 |
3 |
| each() |
返回數組中當前的鍵/值對並將數組指標向前移動一步。 |
3 |
| end() |
將數組的內部指標指向最後一個元素。 |
3 |
| extract() |
從數組中將變數匯入到當前的符號表。 |
3 |
| in_array() |
檢查數組中是否存在指定的值。 |
4 |
| key() |
從關聯陣列中取得鍵名。 |
3 |
| krsort() |
對數組按照鍵名逆向排序。 |
3 |
| ksort() |
對數組按照鍵名排序。 |
3 |
| list() |
把數組中的值賦給一些變數。 |
3 |
| natcasesort() |
用“自然排序”演算法對數組進行不區分大小寫字母的排序。 |
4 |
| natsort() |
用“自然排序”演算法對數組排序。 |
4 |
| next() |
將數組中的內部指標向前移動一位。 |
3 |
| pos() |
current() 的別名。 |
3 |
| prev() |
將數組的內部指標倒回一位。 |
3 |
| range() |
建立一個包含指定範圍的元素的數組。 |
3 |
| reset() |
將數組的內部指標指向第一個元素。 |
3 |
| rsort() |
對數組逆向排序。 |
3 |
| shuffle() |
把數組中的元素按隨機順序重新排列。 |
3 |
| sizeof() |
count() 的別名。 |
3 |
| sort() |
對數組排序。 |
3 |
| uasort() |
使用使用者自訂的比較函數對數組中的值進行排序並保持索引關聯。 |
3 |
| uksort() |
使用使用者自訂的比較函數對數組中的鍵名進行排序。 |
3 |
| usort() |
使用使用者自訂的比較函數對數組中的值進行排序。 |
3 |