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.

Parâmetros

array

O array de entrada.

offset

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.

length

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.

preserve_keys

Note que array_slice() irá reordenar e resetar as chaves numéricas por padrão. Você pode mudar esse comportamento definindo preserve_keys como TRUE.

Valor Retornado

Retorna a parcela.

Changelog

Versão Descrição
5.0.2 O parâmetro opcional preserve_keys foi adicionado.

Exemplos

Example #1 Exemplos da 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() - Remove uma parcela do array e substitui com outros elementos
  • unset() - Destrói a variável especificada