Функция PHP array_unshift()

Функции массива PHP

Пример

Вставить элемент "blue" в массив:

<?php
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Запуск примера

Определение и использование

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

Добавленные элементы добавляются как единое целое, и их порядок в массиве совпадает с порядком в параметрах.

Эта функция возвращает количество элементов в массиве.

Совет:Вы можете вставить один или несколько значений.

Комментарии:Целочисловые ключи начнутся с 0 и будут увеличиваться на 1. Строковые ключи останутся без изменений.

Синтаксис

array_unshift(массив,value1,value2,value3...)
Параметры Описание
массив Обязателен. Определяет массив.
value1 Обязателен. Определяет значение, которое нужно вставить.
value2 Опционально. Определяет значение, которое нужно вставить.
value3 Опционально. Определяет значение, которое нужно вставить.

Технические детали

Возврат значений: Возвращает количество новых элементов в массиве.
Версия PHP: 4+

Более сложные примеры

Пример 1

Отображение возвращаемого значения:

<?php
$a=array("a"=>"red","b"=>"green");
print_r(array_unshift($a,"blue"));
?>

Запуск примера

Пример 2

Использование числовых ключей:

<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Запуск примера

Функции массива PHP