array_spliceRemove uma parte array e a substitui por outra coisa
&reftitle.description;
arrayarray_splicearrayarrayintoffsetintnulllength&null;mixedreplacement[]
Remove os elementos especificados por offset e
length do array array,
e os substitui com os elementos do
array replacement, se for especificado.
Chaves numéricas em array não são preservadas.
Se replacement não for um array, ele será
convertido
para um array (i.e. (array) $replacement). Isso pode resultar em um
comportamento inesperado ao usar um objeto ou replacement &null;.
&reftitle.parameters;
array
O array de entrada.
offset
Se offset for positivo então o começo da
região removida será nesse deslocamento a partir do início do
array array.
Se offset for negativo então o começo da
região removida será nesse deslocamento a partir do final do
array array.
length
Se length for omitido, remove tudo
a partir de offset até o final do array.
Se length for especificado e for positivo,
então essa quantidade de elementos será removida.
Se length for especificado e for negativo,
então o final da região removida será essa quantidade de elementos
a partir do final do array.
Se length for especificado e for zero,
nenhum elemento será removido.
Para remover tudo a partir de offset até o final do
array quando replacement também é especificado,
use count($input) para length.
replacement
Se o array replacement for especificado, então os
elementos removidos serão substituídos pelo elementos desse array.
Se offset e length
são tais que nada é removido, então os elementos do
array replacement serão inseridos no lugar
especificado pelo offset.
Chaves em replacement não são preservadas.
Se replacement for de apenas um elemento
então não é necessário colocar array() ou colchetes
ao redor dele, a não ser que elementos seja um array em si, um objeto ou &null;.
&reftitle.returnvalues;
Retorna um array que consiste nos elementos extraídos.
&reftitle.changelog;
&Version;&Description;8.0.0length agora é anulável.
&reftitle.examples;
Exemplos da <function>array_splice</function>
]]>
&example.outputs;
string(3) "vermelho"
[1]=>
string(5) "verde"
}
array(2) {
[0]=>
string(3) "vermelho"
[1]=>
string(6) "amarelo"
}
array(2) {
[0]=>
string(3) "vermelho"
[1]=>
string(6) "laranja"
}
array(5) {
[0]=>
string(3) "vermelho"
[1]=>
string(5) "verde"
[2]=>
string(4) "azul"
[3]=>
string(5) "preto"
[4]=>
string(6) "marrom"
}
]]>
Declarações equivalentes a vários exemplos da <function>array_splice</function>
As seguintes declarações são equivalentes:
]]>
&reftitle.seealso;
array_mergearray_sliceunset