Manual do PHP
AnteriorPróxima

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 [, bool preserve_keys]] )

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.

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

AnteriorPrincipalPróxima
array_shiftAcimaarray_splice