Podręcznik PHP
Poprzedni |  | Następny

# array_splice

(PHP 4, PHP 5)

array_splice -- Usuń część tablicy i zamień ją na coś innego

## 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().

Poprzedni | Spis treści | Następny
array_slice | Początek rozdziału | array_sum