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