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. 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:

Tabela 1. Równoważności array_splice()

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

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