Função array_slice() do PHP

Exemplo

Começa a extrair a partir do terceiro elemento do array e retorna o resto dos elementos do array:

<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,2));
?>

Executar Exemplo

Definição e uso

A função array_slice() extrai um segmento do array com base em condições específicas e retorna-o.

Notas:Se o array tiver chaves de string, o array retornado manterá os nomes das chaves. (Ver exemplo 4)

Sintaxe

array_slice(array,início,length,preservar)
Parâmetro Descrição
array Obrigatório. Determina o array.
início

Obrigatório. Número. Determina a posição de início da extração. 0 = primeiro elemento.

Se este valor for definido como um número positivo, a extração começará do início.

Se este valor for definido como um número negativo, a extração começará a partir do final, com o valor de start como valor absoluto. -2 significa começar pelo segundo último elemento do array.

length

Opcional. Número. Determina o comprimento do array retornado.

Se este valor for um inteiro, ele retornará a quantidade de elementos especificada.

Se este valor for negativo, a função terminará de extrair tão longe do final do array quanto o valor negativo.

Se este valor não for configurado, todos os elementos a partir da posição definida pelo parâmetro start até o final do array serão retornados.

preservar

Opcional. Determina se a função deve manter ou resetar os nomes de chave. Valores possíveis:

  • true - manter nomes de chave
  • false - padrão. Reiniciar nomes de chave

Detalhes Técnicos

Retorno: Retorna a parte selecionada do array.
Versão PHP: 4+
Log de Atualizações: Adicionado em PHP 5.0.2 preservar Parâmetros.

Mais Exemplos

Exemplo 1

Retirar a partir do segundo elemento do array, retornando apenas dois elementos:

<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,1,2));
?>

Executar Exemplo

Exemplo 2

Usar negativo início Parâmetros:

<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,-2,1));
?>

Executar Exemplo

Exemplo 3

Colocar preservar Parâmetro definido como true:

<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,1,2,true));
?>

Executar Exemplo

Exemplo 4

Tratar nomes de chave de string e inteiros:

<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow","e"=>"brown");
print_r(array_slice($a,1,2));
$a=array("0"=>"red","1"=>"green","2"=>"blue","3"=>"yellow","4"=>"brown");
print_r(array_slice($a,1,2));
?>

Executar Exemplo