array_slice
(PHP 4, PHP 5)
array_slice — Extrai uma parcela de um array
Descrição
array_slice() retorna a sequência de elementos de array especificada pelos parâmetros offset e length .
Se offset for não negativo, 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() irá reiniciar as chaves numericas pr padrão. Desde o PHP 5.0.2, você pode mudar esse funcionamento definindo preserve_keys como TRUE.
Example#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"
// Npote as diferenças nas chaves das arrays
print_r(array_slice($input, 2, -1));
print_r(array_slice($input, 2, -1, true));
?>
O exemplo acima irá imprimir:
Array ( [0] => c [1] => d ) Array ( [2] => c [3] => d }
Veja também array_splice() e unset().