array_spliceUsuwa część tablicy i zamienia ją na coś innego
&reftitle.description;
arrayarray_splicearrayarrayintoffsetintnulllength&null;mixedreplacement[]
Usuwa elementy określone przez parametryoffset i
length z tablicy array
i zamienia je na elementy tablicy
replacement, jeśli została ona podana.
Liczbowe klucze tablicy array nie są zachowywane.
Jeżeli parametr replacement nie jest tablicą, to zostanie on
zrzutowany
na nią (i.e. (array) $replacement). Może to skutkować niespodziewanym
zachowaniem kiedy jako replacement podano obiekt lub &null;.
&reftitle.parameters;
array
Tablica wejściowa.
offset
Jeżeli parametr offset jest dodatni, to początek
usuwanej części tablicy zaczyna się od wartości offset liczonej od
początku tablicy array.
Jeżeli parametr offset jest ujemny, to początek
usuwanej części tablicy zaczyna się od wartości offset liczonej od
końca tablicy array.
length
Jeżeli parametr length zostanie pominięty, to funkcja usunie wszystko
poczynając od wartości offset, do końca tablicy.
Jeżeli parametr length jest określony i jest on dodatni,
to tyle właśnie elementów zostanie usuniętych.
Jeżeli parametr length jest określony i jest on ujemny,
to usuwana część będzie miała tyle właśnie elementów
liczonych od końca tablicy.
Jeżeli parametr length jest podany i wynosi zero,
nie zostaną usunięte żadne elementy.
Aby usunąć wszystko od wartości offset aż do końca
tablicy, gdy podano również replacement,
użyj count($input) jako wartości parametru length.
replacement
Jeżeli parametr replacement jest podany,
to usunięte elementy są zamieniane na elementy podane w tej tablicy.
Jeżeli parametry offset i length
są takie, że nic nie zostanie usunięte, to wtedy elementy z tablicy
replacement są dodawane w miejsce
określone parametrem offset.
Klucze w tablicy replacement nie są zachowywane.
Jeżeli tablica replacement ma tylko jeden element,
to nie jest konieczne ujmowanie jej w array() lub w nawiasy kwadratowe,
chyba że sama jest tablica, obiektem lub &null;.
&reftitle.returnvalues;
Zwraca tablicę składającą się z usuniętych elementów.
&reftitle.changelog;
&Version;&Description;8.0.0length przyjmuje teraz także wartość null.
&reftitle.examples;
Przykłady użycia array_splice
]]>
&example.outputs;
string(3) "red"
[1]=>
string(5) "green"
}
array(2) {
[0]=>
string(3) "red"
[1]=>
string(6) "yellow"
}
array(2) {
[0]=>
string(3) "red"
[1]=>
string(6) "orange"
}
array(5) {
[0]=>
string(3) "red"
[1]=>
string(5) "green"
[2]=>
string(4) "blue"
[3]=>
string(5) "black"
[4]=>
string(6) "maroon"
}
]]>
Przykłady array_splice i ich równoważne alternatywy
Te wyrażenia są tożsame:
]]>
&reftitle.seealso;
array_mergearray_sliceunset