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:
Tabel 1. array_splice() ligheder
| 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.
Se også array_slice(), unset() og array_merge().