array_splice

(PHP 4 >= 4.0.0)

array_splice --  Rimuove una porzione dell'array e la sostituisce con altro

Descrizione

array array_splice (array input, int offset [, int length, array [replacement]])

array_splice() rimuove gli elementi specificati da offset e length dall'array input, e li sostituisce con gli elementi dell'array replacement, se fornito.

Se offset è positivo l'inizio della porzione rimossa è a quella distanza dall'inizio dell'array input. Se offset è negativo inizia a quella distanza dalla fine dell'array input.

Se length è omessa, rimuove tutti gli elementi da offset alla fine dell'array. Se length è specificata a positiva, quel numero di elementi vengono rimossi. Se length è specificata e negativa la porzione da rimuovere terminerà a length elementi dalla fine dell'array. Suggerimento: per rimuovere tutti gli elementi tra offset e la fine dell'array quando è specificato pure replacement, usare count($input) nel parametro length.

Se l'array replacement è specificato, gli elementi rimossi sono sostituiti dagli elementi di questo array. Se offset e length sono tali per cui niente viene rimosso, gli elementi dell'array replacement sono inseriti nella posizione specificata da offset. Suggerimento: se replacement è composto solo da un elemento non è necessario porlo nel costrutto array(), a meno che l'elemento stesso non sia un array.

Valgono le seguenti equivalenze:

array_push ($input, $x, $y)     array_splice ($input, count ($input), 0, 
                                             array ($x, $y))
array_pop ($input)              array_splice ($input, -1)
array_shift ($input)            array_splice ($input, 0, 1)
array_unshift ($input, $x, $y)  array_splice ($input, 0, 0, array ($x, $y))
$a[$x] = $y                     array_splice ($input, $x, 1, $y)
     

Restituisce un array contenente gli elementi rimossi.

Esempio 1. esempi di array_splice()


$input = array ("rosso", "verde", "blu", "giallo");
array_splice ($input, 2);      
// $input è ora array ("rosso", "verde")

$input = array ("rosso", "verde", "blu", "giallo");
array_splice ($input, 1, -1);  
// $input è ora array ("rosso", "giallo")

$input = array ("rosso", "verde", "blu", "giallo");
array_splice ($input, 1, count($input), "arancio");  
// $input è ora array ("rosso", "arancio")

$input = array ("rosso", "verde", "blu", "giallo");
array_splice ($input, -1, 1, array("nero", "marrone")); 
// $input è ora array ("rosso", "verde", 
//          "blu", "nero", "marrone")
      

Vedere anche array_slice().