(PHP 4, PHP 5)
array_slice — Extrai uma parcela de um 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.
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.
Retorna a parcela.
| Versão | Descrição |
|---|---|
| 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); // 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
}