(PHP 4, PHP 5)
array_splice — Usuń część tablicy i zamień ją na coś innego
&$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.
Liczbowe klucze tablicy wejście nie są
zachowywane.
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. Klucze w zamienniku nie są
zachowywane. Jeśli zamiennik to tylko jeden element, to nie trzeba go
wstawiać do array(), chyba że element jest właśnie
tablicą.
Poniższe wyrażenia zmieniają wartość tablicy $wejscie w ten sam sposób:
| 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)) |
| $wejscie[$x] = $y // dla tablic gdzie klucz jest równy przesunięciu | array_splice($wejscie, $x, 1, $y) |
Funkcja zwraca tablicę zawierającą usunięte elementy.
Przykład #1 Przykład użycia array_splice()
<?php
$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")
$wejscie = array("czerwony", "zielony", "niebieski", "żółty");
array_splice($wejscie, 3, 0, "fioletowy");
// $wejscie to teraz array("czerwony", "zielony",
// "niebieski", "fioletowy", "żółty");
?>
Patrz także: array_slice(), unset() i array_merge().