Добавление одного или нескольких элементов в начало массива. Функция array_unshift

Чтобы добавить один или несколько элементов в начало массива,используется функцию array_unshift ():

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

Синтаксис:

• $array (обязательный параметр) - это входной массив в который мы будем добавлять элемент(ы)
• $values (обязательный параметр)-  значение или значения, которые мы хотим поместить в начало массива

Функция array_unshift() возвращает новое количество элементов в массиве.

Обратите внимание, что функция array_unshift() изменяет ИСХОДНЫЙ  массив. Функция array_unshift () добавляет элементы в начало входного массив и сохраняет добавленные элементы в исходном массиве.

Поскольку функция array_unshift() добавляет новые элементы в начало входного массива, она изменяет индексы, чтобы они начинались с нуля. 

Давайте рассмотрим несколько примеров использования функции PHP array_unshift().

Использование функции PHP array_unshift () для добавления одного элемента в массив

В следующем примере функция array_unshift () используется для предварительного добавления элемента в начало массива:

<?php

$permissions = [
	'edit',
	'delete',
	'view'
];

array_unshift($permissions, 'new');

print_r($permissions);

Вывод:

Array
(
    [0] => new
    [1] => edit
    [2] => delete
    [3] => view
)

Как это работает:

• Сначала определяем массив из трех элементов.
• Далее, добавляем  элемент  "new" в начало массива.
• Выводим на экран при помощи функции print_r()

Как вы видите из выходных данных,  элемент "new" получает нулевой индекс, в то время как существующие индексы изменяются соответствующим образом.

Использование функции PHP array_unshift () для добавления нескольких  элементов в начало массива

В следующем примере используется array_unshift () для добавления трех элементов в начало массива:

<?php

$permissions = [
	'edit',
	'delete',
	'view'
];

array_unshift($permissions, 'new', 'approve', 'reject');

print_r($permissions);

Вывод:

Array
(
    [0] => new
    [1] => approve
    [2] => reject
    [3] => edit
    [4] => delete
    [5] => view
)

Добавление элемента в начало ассоциативного массива

Чтобы добавить элемент к ассоциативному массиву, используйте оператор +. Например:

<?php

$colors = [
	'red' => '#ff000',
	'green' => '#00ff00',
	'blue' => '#0000ff',
];

$colors = ['black' => '#000000'] + $colors;

print_r($colors);

Вывод:

Array
(
    [black] => #000000
    [red] => #ff000
    [green] => #00ff00
    [blue] => #0000ff
)