array_splice

(PHP 4, PHP 5, PHP 7, PHP 8)

array_splice — Видаляє частину масиву і замінює її чимось ще

Опис

array_splice(    array &$array,    int $offset,    ?int $length = null,    mixed $replacement = []): array

Видаляє length елементів, розташованих на відстані offsetиз массиваarray, та замінює їх елементами масиву replacement, якщо він передано як параметр.

Зауваження :

Зверніть увагу, що числові ключі в масиві array не зберігаються.

Зауваження: Якщо параметр replacement не є масивом, він буде перетворено до нього (тобто (array) $parameter). Це може призвести до несподіваних результатів під час використання об'єкта або null в якості replacement

Список параметрів

array

Вхідний масив

offset

Якщо параметр offset позитивний, будуть видалені елементи, що знаходяться на відстані offset від початку array

Якщо offset негативний, будуть видалені елементи, що знаходяться на відстані offset від кінця array

length

Якщо параметр length опущено, будуть видалені всі елементи, починаючи з позиції offsetи до конца массива.

Якщо length вказаний і він позитивний, буде видалено саме стільки елементів.

Якщо параметр length від'ємний, то кінець частини елементів, що видаляється, буде відстояти на цю кількість від кінця масиву.

Якщо length заданий як 0, нічого видалено не буде.

Підказка

Порада: щоб видалити всі елементи масиву, починаючи з позиції offsetдо конца массива, в то время как указан параметрreplacement, используйтеcount($input) як параметр length

replacement

Якщо передано масив replacement як аргумент, тоді видалені елементи будуть замінені елементами цього масиву.

Якщо параметри offsetиlength такі, що з вихідного масиву нічого очікувати видалено, тоді елементи масиву replacement буде вставлено на позицію offset

Зауваження :

Обратите внимание, что ключи массиваreplacement не зберігаються.

Порада: якщо replacement є просто одним елементом, немає необхідності укладати його в array() або квадратні дужки, якщо тільки цей елемент сам не є масивом, об'єктом або null

Значення, що повертаються

Повертає масив, що містить видалені елементи.

список змін

Версия	Опис
8.0.0	`length` тепер допускає значення null.

Приклади

Приклад #1 Приклади використання array_splice()

Loading...

Результат виконання наведеного прикладу:

array(2) {
  [0]=>
  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"
}

Приклад #2 Приклади використання array_splice()

Наступні вирази еквівалентні:

Loading...

Дивіться також

array_merge() - Зливає один або більше масивів
array_slice() - Вибирає зріз масиву
unset() - Видаляє змінну