array_push

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

array_push — Push one or more elements onto the end of array

Опис

array_push(array &$array, mixed ...$values): int

array_push() treats array as a stack, and pushes the passed variables onto the end of array. The length of array increases by the number of variables pushed. Has the same effect as:

<?php
$array[] = $var;
?>

repeated for each passed value.

Зауваження: If you use array_push() to add one element to the array, it's better to use $array[] = because in that way there is no overhead of calling a function.

Зауваження: array_push() will raise a warning if the first argument is not an array. This differed from the $var[] behaviour where a new array was created, prior to PHP 7.1.0.

Параметри

array: The input array.
values: The values to push onto the end of the array.

Значення, що повертаються

Returns the new number of elements in the array.

Журнал змін

Версія Опис

7.3.0 This function can now be called with only one parameter. Formerly, at least two parameters have been required.

Версія	Опис
7.3.0	This function can now be called with only one parameter. Formerly, at least two parameters have been required.

Приклади

Приклад #1 array_push() example

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

Поданий вище приклад виведе:

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

Прогляньте також

array_pop() - Pop the element off the end of array
array_shift() - Витягує елемент з початку масиву
array_unshift() - Prepend one or more elements to the beginning of an array