Exemplo
Remover os elementos de uma matriz e substituí-lo com novos elementos:
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
?>
Exemplo executar » Definição e Uso
O array_splice() função remove elementos seleccionados a partir de uma matriz e substitui-la com novos elementos. A função também retorna uma matriz com os elementos removidos.
Tip: Se a função não remover quaisquer elementos (length=0) , a matriz de substituição será inserido a partir da posição do parâmetro de partida (ver Exemplo 2).
Note: As chaves na matriz substituído não são preservadas.
Sintaxe
array_splice( array,start,length,array )
| Parâmetro | Descrição |
|---|---|
| array | Requeridos. Especifica uma matriz |
| start | Requeridos. Valor numérico. Especifica que a função vai começar a remover elementos. 0 = o primeiro elemento. Se este valor é definido como um número negativo, a função vai começar muito longe do último elemento. -2 meios começar no segundo último elemento da matriz. |
| length | Opcional. Valor numérico. Especifica o número de elementos vai ser removida, e também o comprimento da matriz retornada. Se este valor é definido como um número negativo, a função vai parar muito longe do último elemento. Se esse valor não for definido, a função irá remover todos os elementos, a partir da posição definida pelo início parâmetro. |
| array | Opcional. Especifica uma matriz com os elementos que irão ser inseridos à matriz original. Se é apenas um elemento, pode ser uma string, e não tem que ser um array. |
Detalhes técnicos
| Valor de retorno: | Retorna a matriz que consiste nos elementos extraídos |
|---|---|
| PHP Versão: | 4+ |
mais Exemplos
Exemplo 1
O mesmo exemplo como o exemplo no início da página, mas a produção é a matriz retornada:
<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
?>
Exemplo executar » exemplo 2
Com o parâmetro de comprimento definido para 0:
<?php
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
?>
Exemplo executar » <PHP matriz de referência