PHP array_splice()Функции
Полный справочник по массивам PHP
Примеры
Удаляет элементы из массива и заменяет их новыми элементами:
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"жёлтый");
$a2=array("a"=>"фиолетовый","b"=>"оранжевый");
array_splice($a1,0,2,$a2);
print_r($a1);
Запустить пример »
Определение и использование
Функция array_splice() удаляет выбранные элементы из массива и заменяет их новыми элементами. Функция также возвращает массив удалённых элементов.
Совет:Если функция не удаляет ни одного элемента (length=0), массив замены будет вставлен с позиции параметра start (см. Пример 2).
Примечание:Имена ключей в массиве замены не сохраняются.
Синтаксис
array_splice(array1,start,length,array2)
| Параметр | Описание |
|---|---|
| array1 | Обязательный. Указывает массив. |
| start | Обязательный. Числовое значение. Задает начальную позицию для удаления элементов. 0 = первый элемент. Если значение положительное, удаление начинается со смещения, заданного этим значением в массиве. Если значение отрицательное, удаление начинается со смещения, отсчитываемого назад от конца массива. -2 означает начало со второго элемента с конца массива. |
| length | Необязательный. Числовое значение. Задает количество элементов, которые нужно удалить, а также длину возвращаемого массива. Если это значение положительное, удаляется указанное количество элементов. Если это значение отрицательное, удаляются все элементы от start до элемента, отстоящего на length от конца массива. Если это значение не задано, удаляются все элементы от позиции, заданной параметром start, до конца массива. |
| array2 | Необязательный. Задает массив с элементами, которые нужно вставить в исходный массив. Если элемент только один, его можно задать в виде строки, не обязательно как массив. |
Технические детали
| Возвращаемое значение: | Возвращает массив, содержащий извлеченные элементы. |
|---|---|
| Версия PHP: | 4+ |
Другие примеры
Пример 1
Как в примере, приведенном ранее на этой странице, но выводит возвращенный массив:
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"жёлтый");
$a2=array("a"=>"фиолетовый","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
Запустить пример »
Пример 2
Если параметр length установлен в 0:
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"оранжевый");
array_splice($a1,1,0,$a2);
print_r($a1);
Запустить пример »
Полный справочник по массивам PHP Другие расширения