PHP Manual
Prev |  | Next

# array_slice

array_slice -- Extract a slice of the array

## Description

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

array_slice() returns a sequence of elements from the `array` 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`.

Example 1. array_slice() examples

      1
      2 $input = array ("a", "b", "c", "d", "e");
      3
      4 $output = array_slice ($input, 2);      // returns "c", "d", and "e"
      5 $output = array_slice ($input, 2, -1);  // returns "c", "d"
      6 $output = array_slice ($input, -2, 1);  // returns "d"
      7 $output = array_slice ($input, 0, 3);   // returns "a", "b", and "c"
      8

See also array_splice().

> Note: This function was added in PHP 4.0.

Prev | Home | Next
array_shift | Up | array_splice