array_spliceУдаляет часть массива и заменяет её новыми элементами
&reftitle.description;
arrayarray_splicearrayarrayintoffsetintnulllength&null;mixedreplacement[]
Функция удаляет из массива array элементы,
которые обозначили параметрами offset
и length, и заменяет удалённые элементы
элементами массива replacement, если аргумент передали.
Обратите внимание, числовые ключи в массиве array
не сохраняются.
Функция приведёт тип
аргумента replacement к массиву аналогично выражению
(array) $parameter, если передали не массив. Функция ведёт себя
неожиданно при передаче в параметр replacement объекта
или константы &null;.
&reftitle.parameters;
array
Входной массив.
offset
Функция удалит часть массива с позиции смещения, которую отсчитала от начала массива array,
если параметр offset положителен.
Функция удалит часть массива с позиции смещения, которую отсчитала от конца массива array,
если параметр offset отрицателен.
length
Функция удалит каждый элемент от смещения offset до конца массива,
если параметр length опустили.
Функция удалит столько элементов, сколько указали в параметре length,
если указали положительное значение.
Концом части элементов, которую удалит функция, будет такое количество элементов от конца массива,
которое указали как отрицательное значение параметра length.
Функция не удалит элементы, если для параметра length установили значение 0.
Совет: при вызове функции с аргументом replacement
в аргументе length передают выражение count($input),
чтобы удалить из массива элементы от позиции смещения offset до конца массива.
replacement
Функция заменит удаляемые элементы входного массива элементами массива replacement,
если массив с элементами замены передали.
Функция вставит элементы массива replacement в место,
которое начинается со смещения offset,
если передали смещение offset и длину length,
с которыми функция ничего не удаляет.
Обратите внимание, что ключи массива
replacement не сохраняются.
Совет: значение аргумента replacement передают
без конструкции array() или квадратных скобок короткого синтаксиса массивов,
если во входном массиве требуется заменить только одно значение,
если только само значение, которым требуется заменить элемент,
не массив, объект или &null;.
&reftitle.returnvalues;
Функция возвращает массив, который состоит из извлечённых элементов.
&reftitle.changelog;
&Version;&Description;8.0.0
Параметр length теперь принимает значение null.
&reftitle.examples;
Примеры использования функции array_splice
]]>
&example.outputs;
string(3) "red"
[1]=>
string(5) "green"
}
array(2) {
[0]=>
string(3) "red"
[1]=>
string(6) "yellow"
}
array(2) {
[0]=>
string(3) "red"
[1]=>
string(6) "orange"
}
array(5) {
[0]=>
string(3) "red"
[1]=>
string(5) "green"
[2]=>
string(4) "blue"
[3]=>
string(5) "black"
[4]=>
string(6) "maroon"
}
]]>
Примеры инструкций, которые дают эквивалентный функции
array_splice результат
Следующие инструкции эквивалентны:
]]>
&reftitle.seealso;
array_mergearray_sliceunset