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() - Разбивает массив на части
Вернуться к: Функции для работы с массивами