array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.array-push.php', 1 => 'array_push', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.array-product.php', 1 => 'array_product', ), 'next' => array ( 0 => 'function.array-rand.php', 1 => 'array_rand', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/array-push.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Добавляет один или несколько элементов в конец массива
array_push() использует array
как стек и добавляет переданные значения в конец массива array
.
Длина array
увеличивается на количество
переданных значений. Имеет тот же эффект, что и выражение:
<?php
$array[] = $var;
?>
Замечание: Вместо использования array_push() для добавления одного элемента в массив, лучше использовать
$array[] =
, потому что в этом случае не происходит затрат на вызов функции.
Замечание: array_push() вызовет предупреждение, если первый аргумент не является массивом. Это отличается от поведения конструкции
$var[]
до PHP 7.1.0, в случае которой будет создан новый массив.
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 )