array_push
(PHP 4, PHP 5, PHP 7)
array_push — Добавляет один или несколько элементов в конец массива
Описание
array_push() использует array
как стек и добавляет переданные значения в конец массива array.
Длина array увеличивается на количество
переданных значений. Имеет тот же эффект, что и выражение:
<?php
$array[] = $var;
?>
Замечание: Вместо использования array_push() для добавления одного элемента в массив, лучше использовать
$array[] =, потому что в этом случае не происходит затрат на вызов функции.
Замечание: array_push() вызовет предупреждение, если первый аргумент не является массивом. Это отличается от поведения конструкции
$var[], в случае которой будет создан новый массив.
Список параметров
-
array -
Входной массив.
-
values -
Значения, добавляемые в конец массива
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
)
Смотрите также
- array_pop() - Извлекает последний элемент массива
- array_shift() - Извлекает первый элемент массива
- array_unshift() - Добавляет один или несколько элементов в начало массива