array_slice - Выбирает срез массива
Вернуться к: Функции для работы с массивами
array_slice
(PHP 4, PHP 5)
array_slice — Выбирает срез массива
Описание
array_slice() возвращает последовательность элементов массива array, определённую параметрами offset и length.
Замечание: Эта функция при вызове сбрасывает указатель массива, переданного параметром.
Список параметров
- array
-
Входной массив.
- offset
-
Если параметр offset неотрицателен, последовательность начнётся на указанном расстоянии от начала array. Если offset отрицателен, последовательность начнётся на расстоянии указанном расстоянии от конца array.
- length
-
Если в эту функцию передан положительный параметр length, последовательность будет включать количество элементов меньшее или равное length, length, length. Если количество элементов массива меньше чем параметр length, то только доступные элементы массива будут присутствовать. Если в эту функцию передан отрицательный параметр length, последовательность остановится на указанном расстоянии от конца массива. Если он опущен, последовательность будет содержать все элементы с offset до конца массива array.
- preserve_keys
-
Обратите внимание, что по умолчанию array_slice() сбрасывает ключи массива. Вы можете переопределить это поведение, установив параметр preserve_keys в TRUE.
Возвращаемые значения
Возвращает срез.
Список изменений
| Версия | Описание |
|---|---|
| 5.0.2 | Добавлен необязательный параметр preserve_keys. |
Примеры
Пример #1 Пример использования array_slice()
<?php
$input = array("a", "b", "c", "d", "e");
$output = array_slice($input, 2); // возвращает "c", "d", и "e"
$output = array_slice($input, -2, 1); // возвращает "d"
$output = array_slice($input, 0, 3); // возвращает "a", "b", и "c"
// заметьте разницу в индексах массивов
print_r(array_slice($input, 2, -1));
print_r(array_slice($input, 2, -1, true));
?>
Результат выполнения данного примера:
Array
(
[0] => c
[1] => d
)
Array
(
[2] => c
[3] => d
)
Смотрите также
- array_splice() - Удаляет часть массива и заменяет её чем-нибудь ещё
- unset() - Удаляет переменную
- array_chunk() - Разбивает массив на части
Вернуться к: Функции для работы с массивами