array_splice

Descrizione

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

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:

Restituisce un array contenente gli elementi rimossi.

Esempio 1. esempi di array_splice() <?php $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") $input = array("rosso", "verde", "blu", "giallo"); array_splice($input, 3, 0, "viola"); // $input è ora array("rosso", "verde", //          "blu", "viola", "giallo"); ?>

Vedere anche array_slice()i, unset() e array_merge().