PHP Manual
Prev |  | Next

# array_slice

(PHP 4 )

array_slice -- Extract a slice of the array

## Description

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

array_slice() returns the sequence of elements from the array `array` as specified by the `offset` and `length` parameters.

If `offset` is positive, the sequence will start at that offset in the `array`. If `offset` is negative, the sequence will start that far from the end of the `array`.

If `length` is given and is positive, then the sequence will have that many elements in it. If `length` is given and is negative then the sequence will stop that many elements from the end of the array. If it is omitted, then the sequence will have everything from `offset` up until the end of the `array`.

Note that array_slice() will ignore array keys, and will calculate offsets and lengths based on the actual positions of elements within the array.

Example 1. array_slice() examples

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

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

See also array_splice().

Prev | Home | Next
array_shift | Up | array_splice