array_slice

(PHP 4, PHP 5)

array_slice -- Выбрать срез массива

Описание

array array_slice ( array array, int offset [, int length [, bool preserve_keys]] )

array_slice() возвращает последовательность элементов массива array, определённую параметрами offset и length.

Если параметр offset положителен, последовательность начнётся на расстоянии offset от начала array. Если offset отрицателен, последовательность начнётся на расстоянии offset от конца array.

Если в эту функцию передан положительный параметр length, последовательность будет включать length элементов. Если в эту функцию передан отрицательный параметр length, в последовательность войдут все элементы исходного массива, начиная с позиции offset и заканчивая позицией, отстоящей на length элементов от конца array. Если этот параметр будет опущен, в последовательность войдут все элементы исходного массива array, начиная с позиции offset.

Обратите внимание, что array_slice() сбрасывает ключи массива. Начиная с PHP 5.0.2 вы можете переопределить это поведение, установив параметр preserve_keys в TRUE.

Пример 1. Пример использования array_slice()

<?php
$input
= array("a", "b", "c", "d", "e");

$output = array_slice($input, 2);      // returns "c", "d", and "e"
$output = array_slice($input, -2, 1);  // returns "d"
$output = array_slice($input, 0, 3);   // returns "a", "b", and "c"

// note the differences in the array keys
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().