array_push

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

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

說(shuō)明

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

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

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

注意: 如果用 array_push() 來(lái)給數(shù)組增加一個(gè)單元,還不如用 $array[] = ,因?yàn)檫@樣沒(méi)有調(diào)用函數(shù)的額外負(fù)擔(dān)。

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

參數(shù)

array

輸入的數(shù)組。

value1

要壓入 array 末尾的第一個(gè)值。

返回值

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

更新日志

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

范例

示例 #1 array_push() 例子

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

以上例程會(huì)輸出:

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

參見(jiàn)

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