array_splice
(PHP 4, PHP 5)
array_splice — Fjerner en del af at array og udskifter det med noget andet
Beskrivelse
array_splice() fjerner elementer som angivet ved offset og length fra arrayet input og udskriver dem med elementer fra replacement arrayet, hvis dette argument er angivet. Den returnerer et array som indeholder de fjernede elementer.
Hvis offset er positiv vil fjernelsen af elementer starte fra den afstand fra begyndelsen af input arrayet. Hvis offset er negativ, vil funktionen starte fjernelsen af elementerne fra den afstand fra slutningen af input arrayet.
Hvis length ikke er angivet, bliver alle elementer fra offset til enden af arrayet fjernet. Hvis length er sat og er positiv, vil dette antal af elemter blive fjernet. Hvis length er sat og negativ vil funktionen stoppe med af fjerne elementer efter den afstand fra enden af arrayet. Tip: for at fjerne alt fra offset til enden af arrayet, replacement skal være sat, kan du bruge count($input) til length .
Hvis replacement arrayet er sat, vil de fjernede elementer bliver udskiftet med elementerne fra dette array. Hvis offset og length falder sammen så ingenting bliver fjernet, vil elementerne fra replacement arrayet blive indsat det sted som er angivet ved offset . Bemærk, at nøglerne fra det angivne array ikke vil blive bevaret. Hvis replacement kun indeholer et element, er det ikke nødvendig at indsætte det i en array(), med mindre at elementet er et array i sig selv.
De følgende eksempler ændre værdierne af $input på samme måde:
| 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)) |
| $input[$x] = $y // til arrays hvor nøgler er det samme som forskydningen | array_splice($input, $x, 1, $y) |
Returnerer et array som indeholder de fjernede elementer.
Example#1 array_splice() eksempler
<?php
$input = array("red", "green", "blue", "yellow");
array_splice($input, 2);
// $input er nu array("red", "green")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, -1);
// $input er nu array("red", "yellow")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 1, count($input), "orange");
// $input er nu array("red", "orange")
$input = array("red", "green", "blue", "yellow");
array_splice($input, -1, 1, array("black", "maroon"));
// $input er nu array("red", "green",
// "blue", "black", "maroon")
$input = array("red", "green", "blue", "yellow");
array_splice($input, 3, 0, "purple");
// $input er nu array("red", "green",
// "blue", "purple", "yellow");
?>
Se også array_slice(), unset() og array_merge().