(PHP 4, PHP 5, PHP 7)
array_slice — Extrai uma parcela de um array
$array
, int $offset
[, int $length = NULL
[, bool $preserve_keys = false
]] ) : array
array_slice() retorna a sequência de elementos
de um array delimitado pelos parâmetros
offset e length.
arrayO 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 o array for
menor que length, então somente os elementos
disponíveis serão retornados. Se
length for especificado e negativo então
a sequência conterá essa 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.
Retorna a parcela. Se o offset é maior que o tamanho do array então retorna um array vazio.
| Versão | Descrição |
|---|---|
| 5.2.4 |
O valor parão de length foi modigicado para NULL. Um length NULL agora diz à função para utilizar o comprimento de array. Antes dessa versão, length NULL significava comprimento zero (nada seria retornado).
|
| 5.0.2 |
O parâmetro opcional preserve_keys foi adicionado.
|
Exemplo #1 Exemplos da array_slice()
<?php
$input = array("a", "b", "c", "d", "e");
$output = array_slice($input, 2); // returns "c", "d", and "e"
$output = array_slice($input, -2, 1); // returns "d"
$output = array_slice($input, 0, 3); // returns "a", "b", and "c"
// note the differences in the array keys
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
}