array_slice
Wycina kawałek tablicy
&reftitle.description;
arrayarray_slice
arrayarray
intoffset
intnulllength&null;
boolpreserve_keys&false;
array_slice zwraca sekwencję elementów
z tablicy array zaczynającą się od parametru
offset i długości length.
parameters.
&reftitle.parameters;
array
Tablica wejściowa.
offset
Jeżeli parametr offset nie jest ujemny, sekwencja
zacznie się na podanym przesunięciu w tablicy array.
Jeżeli parametr offset jest ujemny, sekwencja
rozpocznie się od końca tablicy array.
Parametr offset określa pozycję
w tablicy, a nie klucz.
length
Jeżeli podano parametr length i jest on dodatni,
to sekwencja będzie miała maksymalnie tyle elementów, ile podano.
Jeżeli tablica jest mniejsza niż parametr length,
to zostaną zwrócone tylko dostępne elementy tablicy.
Jeżeli podano ujemny parametr length, to
sekwencja zakończy się na tylu elementach, ile w nim podano, licząc od końca tablicy.
Jeżeli ten parametr zostanie pominięty, to sekwencja będzie zawierała
wszystkie elementy począwszy od offset aż do samego
końca tablicy array.
preserve_keys
array_slice domyślnie przenumerowuje i resetuje numeryczne
klucze tablicy. Można zmienić to zachowanie
ustawiając preserve_keys na &true;.
Klucze będące ciągami znaków są zawsze zachowywane, niezależnie od tego parametru.
&reftitle.returnvalues;
Zwraca wycinek tablicy. Jeżeli podane przesunięcie jest większe niż wycinek tablicy,
to zwrócona zostanie pusta tablica.
&reftitle.examples;
Przykłady użycia array_slice
]]>
&example.outputs;
c
[1] => d
)
Array
(
[2] => c
[3] => d
)
]]>
array_slice i tablica rozpoczynająca się od 1
"a", "b", "c", "d", "e");
print_r(array_slice($input, 1, 2));
?>
]]>
&example.outputs;
b
[1] => c
)
]]>
array_slice i tablica z mieszanymi kluczami
'jabłko', 'b'=>'banan', '42'=>'gruszka', 'd'=>'pomarańcza');
print_r(array_slice($ar, 0, 3));
print_r(array_slice($ar, 0, 3, true));
?>
]]>
&example.outputs;
jabłko
[b] => banan
[0] => gruszka
)
Array
(
[a] => jabłko
[b] => banan
[42] => gruszka
)
]]>
&reftitle.seealso;
array_chunk
array_splice
unset