array_push

(PHP 4, PHP 5, PHP 7, PHP 8)

array_push — 將一個或多個單元壓入數組的末尾（入棧）

說明

array_push(array &$array, mixed $value1, mixed $... = ?): int

array_push() 將 array 當成一個棧，并將傳入的變量壓入 array 的末尾。array 的長度將根據入棧變量的數目增加。和如下效果相同：

<?php
$array[] = $var;
?>
并對每個傳入的值重復以上動作。

注意: 如果用 array_push() 來給數組增加一個單元，還不如用 $array[] = ，因為這樣沒有調用函數的額外負擔。

注意: 如果第一個參數不是數組，array_push() 將發(fā)出一條警告。這和 $var[] 的行為不同，在 PHP 7.1.0 之前的版本中，后者將會新建一個數組。

參數

array

輸入的數組。

value1

要壓入 array 末尾的第一個值。

返回值

返回處理之后數組的元素個數。

更新日志

版本 說明
7.3.0 可以只用一個參數來調用此函數，之前版本中至少需要兩個參數。

范例

示例 #1 array_push() 例子

<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>

以上例程會輸出：

Array
(
    [0] => orange
    [1] => banana
    [2] => apple
    [3] => raspberry
)

參見