Funkcja PHP array_splice()

Funkcja PHP array_splice() usuwa z tablicy określony zakres elementów i ewentualnie wstawia w jego miejsce inne elementy. W wyniku wykonania tej funkcji może dojść do zmiany indeksów numerycznych.

Przykład

Usunięcie trzech elementów z tablicy i wstawienie w ich miejsce trzech innych za pomocą funkcji PHP array_splice().


$a = ["a", "b", "c", "d"];
array_splice($a, 1, 3, ["e", "f", "g"]);

Z tablicy $a zostały usunięte elementy o indeksach od 1 do 3 i w ich miejsce zostały wstawione trzy inne elementy.

Składnia funkcji PHP array_splice()

Funkcja PHP array_splice() ma następującą składnię:

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

Parametry

Parametr	Opis
`array`	Parametr obowiązkowy. Tablica, która ma zostać poddana modyfikacji.
`offset`	Parametr obowiązkowy. Indeks pierwszego elementu wycinka tablicy, który ma zostać usunięty. Jeśli ma wartość ujemną, to odliczanie jest wykonywane od końca tablicy.
`length`	Długość usuwanego odcinka: Jeśli zostanie pominięty: funkcja usuwa wszystko od elementu `offset` do końca tablicy. Jeśli jest dodatni: funkcja usuwa określoną liczbę elementów. Jeśli jest ujemny: funkcja usuwa określoną liczbę elementów od końca. Jeśli ma wartość 0: funkcja nie usuwa żadnych elementów.
`replacement`	Jeśli ten argument zostanie przekazany, to funkcja zastąpi usunięte elementy elementami z tego argumentu. Jeśli jako argument zostanie przekazana wartość innego typu niż tablica, to zostanie ona przekonwertowana na tablicę. Jeśli ustawienia argumentów `offset` i `length` sprawiają, że żaden element nie jest usuwany, to nowe elementy zostają wstawione od miejsca wskazywanego przez `offset`. Jeśli argument `replacement` zawiera tylko jeden element, to nie ma potrzeby umieszczać w go nawiasie prostokątnym ani konstrukcji `array()`.

Wartość zwrotna

Funkcja PHP array_splice() zwraca tablicę zawierającą usunięte elementy.

Typ zwrotny: array.

Składnia funkcji PHP array_splice()

Parametry

Wartość zwrotna

Zobacz również

Dodaj komentarz Anuluj pisanie odpowiedzi