array_push
(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Додає один або кілька елементів до кінця масиву
Опис
array_push(array &$array, mixed ...$values): int
array_push() використовує array як стек і додає передані значення в кінець масиву array. Довжина array збільшується кількість переданих значень. Має той самий ефект, що й вираз:
повторене для кожного переданого значення.
Зауваження: Вместо использованияarray_push() для додавання одного елемента до масиву, краще використовувати
$array[] =, тому що в цьому випадку немає витрат на виклик функції.
Зауваження array_push() викликає попередження, якщо перший аргумент не є масивом. Це відрізняється від поведінки конструкції
$var[]до PHP 7.1.0, у разі якої буде створено новий масив.
Список параметрів
array
Вхідний масив
values
Значення, що додаються до кінця масиву array
Значення, що повертаються
Повертає нову кількість елементів у масиві.
список змін
| Версия | Опис |
|---|---|
| 7.3.0 | Тепер ця функція може бути викликана одним параметром. Раніше потрібно було мінімум два параметри. |
Приклади
Приклад #1 Приклад використання array_push()****
Результат виконання наведеного прикладу:
Array
(
[0] => orange
[1] => banana
[2] => apple
[3] => raspberry
)
Дивіться також
- array_pop() - Витягує останній елемент масиву
- array_shift() - Витягує перший елемент масиву
- array_unshift() - Додає один або кілька елементів на початок масиву