array_splice

Opis

array array_splice ( array wejście, int przesunięcie [, int długość [, array zamiennik]] )

array_splice() usuwa z tablicy wejście elementy określone przez parametry przesunięcie i długość, i zamienia je przez elementy tablicy zamiennik, jeśli została ona podana. Funkcja zwraca tablice zawierającą usunięte elementy.

Jeśli przesunięcie jest dodatnie, to początek usuwanej części tablicy wejście znajduje się w miejscu określonym przez ten parametr. Jeśli przesunięcie jest ujemne, to wycinanie zaczyna się o tyle elementów od końca tablicy wejście.

Jeśli długość została pominięta, to usunięte jest wszystko od przesunięcie do końca tablicy. Jeśli długość jest podana i dodatnia, to tyle elementów zostanie usuniętych. Jeśli długość jest podana i jest ujemna, to koniec usuwanego kawałka tablicy będzie się znajdował o tyle elementów od końca tablicy. Wskazówka: aby usunąć wszystko od przesunięcie do końca tablicy podając także parametr zamiennik, użyj count($wejście) jako długość.

Jeśli podana została tablica zamiennik, to wszystkie usunięte elementy są zamieniane na elementy z tej tablicy. Jeśli przesunięcie i długość zostały podane tak, że żadne elementy nie zostaną usunięte, to elementy z tablicy zamiennik są wstawiane w miejsce określone przez przesunięcie. Wskazówka: jeśli zamiennik to tylko jeden element, to nie trzeba go wstawiać do array(), chyba że element jest właśnie tablicą.

Równoznaczności kodu:

array_push ($wejscie, $x, $y)     array_splice ($wejscie, count ($wejscie), 0,                                                array ($x, $y)) array_pop ($wejscie)              array_splice ($wejscie, -1) array_shift ($wejscie)            array_splice ($wejscie, 0, 1) array_unshift ($wejscie, $x, $y)  array_splice ($wejscie, 0, 0, array ($x, $y)) $input[$x] = $y                   array_splice ($wejscie, $x, 1, $y)

Funkcja zwraca tablicę zawierającą usunięte elementy.

Przykład 1. Przykład użycia array_splice() $wejscie = array ("czerwony", "zielony", "niebieski", "żółty"); array_splice ($wejscie, 2);       // $wejscie to teraz array ("czerwony", "zielony") $wejscie = array ("czerwony", "zielony", "niebieski", "żółty"); array_splice ($wejscie, 1, -1);   // $wejscie to teraz array ("czerwony", "żółty") $wejscie = array ("czerwony", "zielony", "niebieski", "żółty"); array_splice ($wejscie, 1, count($wejscie), "pomarańczowy");   // $wejscie to teraz array ("czerwony", "pomarańczowy") $wejscie = array ("czerwony", "zielony", "niebieski", "żółty"); array_splice ($wejscie, -1, 1, array("czarny", "kasztanowy")); // $wejscie to teraz array ("czerwony", "zielony", //          "niebieski", "czarny", "kasztanowy")

Patrz także: array_slice().