Функция PHP array_splice()
Пример
Удалить элементы из массива и заменить его новыми элементами:
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
?>
Определение и использование
Функция array_splice() удаляет выбранные элементы из массива и заменяет его новыми элементами. Функция также возвращает массив с удаленными элементами.
Совет: Если функция не удаляет элементы (длина = 0), замененный массив будет вставлен с позиции начального параметра (см. Пример 2).
Примечание . Ключи в замененном массиве не сохраняются.
Синтаксис
array_splice(array, start, length, array)
Значения параметров
Parameter | Description |
---|---|
array | Required. Specifies an array |
start | Required. Numeric value. Specifies where the function will start
removing elements.
0 = the first element.
If this value is set to a negative number, the function will start that far from the last element.
-2 means start at the second last element of the array. |
length | Optional. Numeric value. Specifies how many elements will
be removed, and also length of the returned array.
If this value is set to a negative number, the function will stop that far from the last element. If this value is not set, the function will
remove all elements, starting from the position set by the start-parameter.
|
array | Optional. Specifies an array with the elements that will be inserted to the original array. If it's only one element, it can be a string, and does not have to be an array. |
Технические детали
Возвращаемое значение: | Возвращает массив, состоящий из извлеченных элементов |
---|---|
Версия PHP: | 4+ |
Дополнительные примеры
Пример 1
Тот же пример, что и в примере вверху страницы, но на выходе — возвращаемый массив:
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
?>
Пример 2
С параметром длины, установленным на 0:
<?php
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
?>
❮ Справочник по массивам PHP