array_push

(PHP 4, PHP 5)

array_push — Добавляет один или несколько элеметов в конец массива

Описание

int array_push ( array &$array , mixed $var [, mixed $... ] )

array_push() использует array как стэк, и добавляет переданные значения в конец массива array. Длина array увеличивается на количество переданных значений. Имеет тот же эффект, что и выражение:


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

повторенное для каждой var.

Замечание: Вместо использования array_push() для добавления одного элемента в массив, лучше использовать $array[] = , потому что в этом случае не происходит затрат на вызов функции.

Замечание: array_push() вызовет предупреждение, если первый аргумент не является массивом. Это отличается от поведения конструкции $var[], в случае которой будет создан новый массив.

Список параметров

array: Входной массив.
var: Записываемое значение.

Возвращаемые значения

Возвращает новое количество элементов в массиве.

Примеры

Пример #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() - Добавляет один или несколько элементов в начало массива