Remova um elemento de um array e substitua-o por um novo elemento:
<?php$a1=array("a"=>"vermelho","b"=>"verde","c"=>"azul","d"=>"amarelo");$a2=array( "a"=>"roxo","b"=>"laranja");array_splice($a1,0,2,$a2);print_r($a1);?>A função array_splice() remove um elemento selecionado de um array e o substitui por um novo elemento. A função também retornará um array de elementos removidos.
Dica: Se a função não remover nenhum elemento (comprimento = 0), o array de substituição será inserido a partir da posição do parâmetro inicial (ver Exemplo 2).
Nota: Os nomes das chaves nas matrizes de substituição não são preservados.
array_splice( matriz,início,comprimento,matriz )
parâmetro | descrever |
---|---|
variedade | Obrigatório. Especifica uma matriz. |
começar | Obrigatório. valor numérico. Especifica a posição inicial dos elementos excluídos. 0 = primeiro elemento. Se o valor for definido como um número positivo, a remoção começará no deslocamento na matriz especificada pelo valor. Se o valor for definido como um número negativo, a remoção começará no deslocamento especificado pelo valor no final da matriz. -2 significa começar do penúltimo elemento da matriz. |
comprimento | Opcional. valor numérico. Especifica o número de elementos a serem removidos, que também é o comprimento da matriz retornada. Se o valor for definido como um número positivo, esse número de elementos será removido. Se este valor for definido como um número negativo, todos os elementos do início ao comprimento recíproco do final da matriz serão removidos. Se este valor não for definido, todos os elementos da posição definida pelo parâmetro inicial até o final do array serão removidos. |
variedade | Opcional. Especifica o array com os elementos a serem inseridos no array original. Se houver apenas um elemento, ele poderá ser definido como uma string e não precisará ser definido como uma matriz. |
Valor de retorno: | Retorna um array contendo os elementos extraídos. |
---|---|
Versão PHP: | 4+ |
Igual ao exemplo anterior nesta página, mas gera o array retornado:
<?php$a1=array("a"=>"vermelho","b"=>"verde","c"=>"azul","d"=>"amarelo");$a2=array( "a"=>"roxo","b"=>"laranja");print_r(array_splice($a1,0,2,$a2));?>Com o parâmetro de comprimento definido como 0:
<?php$a1=array("0"=>"vermelho","1"=>"verde");$a2=array("0"=>"roxo","1"=>"laranja") ;array_splice($a1,1,0,$a2);print_r($a1);?>