PHP array_splice()Funciones
Manual de referencia completo de PHP Array
Ejemplos
Elimina elementos de un array y sustitúyelos por elementos nuevos:
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
array_splice($a1,0,2,$a2);
print_r($a1);
Ejecutar ejemplo »
Definición y uso
La función array_splice() elimina los elementos seleccionados de un array y los sustituye por elementos nuevos. La función también devuelve un array con los elementos eliminados.
Consejo:Si la función no elimina ningún elemento (length=0), el array de reemplazo se insertará en la posición del parámetro start (ver el ejemplo 2).
Nota:No se conservan las claves del array de reemplazo.
Sintaxis
array_splice(array1,start,length,array2)
| Parámetro | Descripción |
|---|---|
| array1 | Obligatorio. Especifica el array. |
| start | Obligatorio. Numérico. Especifica la posición inicial para eliminar elementos.
0 = el primer elemento.
Si el valor se establece como positivo, la eliminación comienza en el desplazamiento especificado por ese valor dentro del array. Si el valor se establece como negativo, la eliminación comienza en el desplazamiento especificado por ese valor contando desde el final del array.
-2 significa que comienza desde el penúltimo elemento del array. |
| length | Opcional. Numérico. Especifica el número de elementos a eliminar, que también es la longitud del array devuelto.
Si el valor se establece como positivo, se elimina esa cantidad de elementos. Si el valor se establece como negativo, se eliminan todos los elementos intermedios desde start hasta el elemento contado como length desde el final del array. Si el valor no se establece, se eliminan todos los elementos desde la posición establecida por el parámetro start hasta el final del array. |
| array2 | Opcional. Especifica un array con los elementos a insertar en el array original. Si solo hay un elemento, se puede establecer como una cadena, sin necesidad de usar un array. |
Detalles técnicos
| Valor de retorno: | Devuelve un array que contiene los elementos extraídos. |
|---|---|
| Versión de PHP: | 4+ |
Más ejemplos
Ejemplo 1
Igual que el ejemplo de la sección anterior de esta página, pero muestra el array devuelto:
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
Ejecutar ejemplo »
Ejemplo 2
Con el parámetro length establecido en 0:
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
Ejecutar ejemplo »
Manual de referencia completo de PHP Array Otras extensiones