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 )