PHP - Função array_splice ()
Sintaxe
array_splice ( $input, $offset [,$length [,$replacement]] );
Definição e Uso
Esta função remove os elementos designados por offset e length de input array, e os substitui pelos elementos do replacementarray, se fornecido. Ele retorna uma matriz contendo os elementos extraídos.
Parâmetros
Sr. Não | Parâmetro e Descrição |
---|---|
1 | input(Required) Ele especifica uma matriz |
2 | offset Ele especifica onde a função começará a remover elementos. 0 = o primeiro elemento. |
3 | length(Optional) Ele especifica quantos elementos serão removidos e também o comprimento do array retornado. |
4 | replacement(Optional) Ele especifica uma matriz com os elementos que serão inseridos na matriz original. |
Valores Retornados
Ele retorna o último valor da matriz, encurtando a matriz em um elemento.
Exemplo
Experimente o seguinte exemplo -
<?php
$input = array("red", "black", "pink", "white");
array_splice($input, 2);
print_r($input);
print_r("<br />");
$input = array("red", "black", "pink", "white");
array_splice($input, 1, -1);
print_r($input);
print_r("<br />");
$input = array("red", "black", "pink", "white");
array_splice($input, 1, count($input), "orange");
print_r($input);
print_r("<br />");
$input = array("red", "black", "pink", "white");
array_splice($input, -1, 1, array("black", "maroon"));
print_r($input);
print_r("<br />");
$input = array("red", "black", "pink", "white");
array_splice($input, 3, 0, "purple");
print_r($input);
print_r("<br />");
?>
Isso produzirá o seguinte resultado -
Array ( [0]=>red [1] =>black )
Array ( [0]=>red [1] =>white )
Array ( [0]=>red [1] =>orange )
Array ( [0]=>red [1] =>black [2]=>pink [3]=>black [4]=>maroon )
Array ( [0]=>red [1] =>black [2]=>pink [3]=>purple [4]=>white )