array_push

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

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

    Описание

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

    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 )

    Смотрите также

    • array_pop() - Извлекает последний элемент массива
    • array_shift() - Извлекает первый элемент массива
    • array_unshift() - Добавляет один или несколько элементов в начало массива
    To Top