Función array_splice() de PHP

Ejemplo

Eliminar elementos del array y reemplazarlos con nuevos elementos:

<?php
$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);
?>

Ejemplo de ejecución

Definición y uso

La función array_splice() elimina elementos seleccionados del array y los reemplaza con nuevos elementos. También devuelve el array que contiene los elementos eliminados.

Consejo:Si la función no elimina ningún elemento (length=0), se comenzará a start Inserta el array reemplazado en la posición de los parámetros (ver ejemplo 2).

Notas:No se conservan los nombres de clave del array reemplazado.

Descripción

La función array_splice() es similar a array_slice() La función es similar, selecciona una serie de elementos en el array, pero no los devuelve, sino que los elimina y los reemplaza con otros valores.

Si se proporciona un cuarto parámetro, los elementos seleccionados anteriormente serán reemplazados por el array especificado por el cuarto parámetro.

El array generado finalmente se devolverá.

Sintaxis

array_splice(array,start,length,array)
Parámetros Descripción
array Obligatorio. Define el array.
start

Obligatorio. Número. Define la posición de inicio para eliminar elementos.

  • 0 = primer elemento.
  • Si el valor se establece en un número positivo, se comenzará a eliminar desde el desplazamiento especificado por el valor en el array.
  • Si el valor se establece en un número negativo, se comenzará a eliminar desde el extremo final del array con el desplazamiento especificado por el valor.
  • -2 significa que comienza desde el segundo elemento a partir del final del array.
length

Opcional. Número. Define la cantidad de elementos a eliminar, también es la longitud del array devuelto.

  • Si se establece este valor en un número positivo, se eliminan la cantidad especificada de elementos.
  • Si se establece este valor en un número negativo, se eliminan todos los elementos desde la posición start hasta el final del array, contando length como el número de elementos restantes.
  • Si no se establece este valor, se eliminan todos los elementos desde la posición establecida por el parámetro start hasta el final del array.
array

Opcional. Define el array que contiene los elementos que se deben insertar en el array original.

Si solo hay un elemento, puede establecerse como una cadena sin establecerse como un array.

Detalles técnicos

Valor de retorno: Devuelve un array compuesto por los elementos extraídos.
Versión de PHP: 4+

Más ejemplos

Ejemplo 1

Como en el ejemplo anterior de esta página, pero el resultado devuelto es el array:

<?php
$a1=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow");
$a2=array("a"=>"purple","b"=>"orange");
print_r(array_splice($a1,0,2,$a2));
?>

Ejemplo de ejecución

Ejemplo 2

Establecer el parámetro length en 0:

<?php
$a1=array("0"=>"red","1"=>"green");
$a2=array("0"=>"purple","1"=>"orange");
array_splice($a1,1,0,$a2);
print_r($a1);
?>

Ejemplo de ejecución