Manual do PHP
Anterior |  | Pró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().

Anterior | Principal | Próxima
array_shift | Acima | array_splice