array_push

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

array_push 將一個或多個單元壓入數(shù)組的末尾(入棧)

說明

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

array_push()array 當(dāng)成一個棧,并將傳入的變量壓入 array 的末尾。array 的長度將根據(jù)入棧變量的數(shù)目增加。和如下效果相同:

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

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

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

參數(shù)

array

輸入的數(shù)組。

value1

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

返回值

返回處理之后數(shù)組的元素個數(shù)。

更新日志

版本 說明
7.3.0 可以只用一個參數(shù)來調(diào)用此函數(shù),之前版本中至少需要兩個參數(shù)。

范例

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

參見

  • array_pop() - 彈出數(shù)組最后一個單元(出棧)
  • array_shift() - 將數(shù)組開頭的單元移出數(shù)組
  • array_unshift() - 在數(shù)組開頭插入一個或多個單元