array_slice - Выбирает срез массива
Вернуться к: Функции для работы с массивами
array_slice
(PHP 4, PHP 5, PHP 7)
array_slice — Выбирает срез массива
Описание
$array
, int $offset
[, int $length = NULL
[, bool $preserve_keys = false
]] )
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.2.4 |
Значение по умолчанию для параметра length было изменено на
NULL. Значение NULL для length
теперь указывает функции использовать длину массива array.
До этой версии NULL для length приравнивался к нулю
(ничего не возвращалось).
|
| 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() - Разбивает массив на части
Вернуться к: Функции для работы с массивами