# Функция array_unshift

Функция `array_unshift` добавляет элементы в начало массива. При этом переданный массив изменяется, а функция возвращает новое количество элементов в массиве. Элементы для добавления перечисляются через запятую.

## Синтаксис

`array_unshift(массив, новые элементы);`

## Пример

Давайте добавим в начало массива еще `2` элемента:

`<?php $arr = [1, 2, 3, 4, 5]; $num = array_unshift($arr, 'a', 'b'); var_dump($arr); ?>`

Результат выполнения кода:

`['a', 'b', 1, 2, 3, 4, 5]`

В переменной $num будет лежать новое количество элементов массива:

`7`

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

- функцию `array_shift`,
  которая извлекает первый элемент массива

← →
↑