array_slice

(PHP 4 , PHP 5)

array_slice -- Extrai uma parcela de um array

Descrição

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

array_slice() retorna a sequência de elementos de array especificada pelos parâmetros offset e length.

Se offset for positivo, a sequência começará do início de array. Se offset for negativo, a sequência começará dessa distância do final de array.

Se length for especificado e positivo, então a sequência terá essa quantidade de elementos. Se length for especificado e negativo então a sequência pará dessa quantidade elementos a partir do final do array. Se for omitido, então a sequência terá todos os elementos a partir de offset até o final de array.

Note que array_slice() ignorará chaves e irá calcular os inícios e comprimentos dos intervalos baseada na posição absoluta dos elementos no array.

Exemplo 1. Exemplos de array_slice()

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

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

Veja também array_splice() e unset().