array_splice

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. 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:

Tabella 1. array_splice() equivalents

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, -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()
<?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().