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().