String.prototype.split()

Sintaxis

cadena.split([separador][,limite])

Parmetros

separador

Especifica el carcter a usar para la separacin de la cadena. El separador es tratado como una cadena o como una expresin regular. Si se omite el separador, el array devuelto contendr un slo elemento con la cadena completa.

limite

Opcional. Entero que especifica un lmite sobre el nmero de divisiones a realizar. El mtodo split() todava se divide en todas las concordancias del separador, pero divide la matriz devuelta en la cantidad de elementos impuesta por el limite.

Descripcin

El mtodo split() devuelve el nuevo array.

Cuando se encuentra, el separador es eliminado de la cadena y las subcadenas obtenidas se devuelven en un array. Si el separador no es encontrado o se omite, el array contendr un nico elemento con la cadena original completa. Si el separador es una cadena vaca la cadena es convertida en un array de carcteres.

Si el separador es una expresin regular que contiene parntesis de captura, entonces cada vez que el separador concuerda, los resultados (includo cualquier resultado indefinido) de los parntesis de captura son divididos en el array resultante. Sin embargo no todos los navegadores soportan esta caracterstica.

Ejemplos

Usando split()

El siguiente ejemplo define una funcin que divide una cadena en un array de cadenas usando el separador especificado. Despus de la divisin de la cadena, la funcin muestra mensajes indicando la cadena original (antes de la divisin), el separador usado, el nmero de elementos del array y los elementos individuales del array.

function dividirCadena(cadenaADividir, separador) {
  var arrayDeCadenas = cadenaADividir.split(separador);
  document.write('<p>La cadena original es: "' + cadenaADividir + '"');
  document.write('<br>El separador es: "' + separador + '"');
  document.write(
    "<br>El array tiene " + arrayDeCadenas.length + " elementos: ",
  );

  for (var i = 0; i < arrayDeCadenas.length; i++) {
    document.write(arrayDeCadenas[i] + " / ");
  }
}

var cadenaVerso = "Oh brave new world that has such people in it.";
var cadenaMeses = "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec";

var espacio = " ";
var coma = ",";

dividirCadena(cadenaVerso, espacio);
dividirCadena(cadenaVerso);
dividirCadena(cadenaMeses, coma);

Este ejemplo produce el siguiente resultado:

La cadena original es: "Oh brave new world that has such people in it."
El separador es: " "
El array tiene 10 elementos: Oh / brave / new / world / that / has / such / people / in / it. /

La cadena original es: "Oh brave new world that has such people in it."
El separador es: "undefined"
El array tiene 1 elementos: Oh brave new world that has such people in it. /

La cadena original es: "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"
El separador es: ","
El array tiene 12 elementos: Jan / Feb / Mar / Apr / May / Jun / Jul / Aug / Sep / Oct / Nov / Dec /

Eliminar espacios de una cadena

En el siguiente ejemplo, split busca 0 o ms espacios seguidos de un punto y coma seguido por 0 o ms espacios y, cuando los halla, elimina los espacios de la cadena. listaNombres es el array devuelto como resultado de la llamada a split.

var nombres = "Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand ";
document.write(nombres + "<br>" + "<br>");
var expresionRegular = /\s*;\s*/;
var listaNombres = nombres.split(expresionRegular);
document.write(listaNombres);

Esto imprime dos lneas; la primera lnea imprime la cadena original, y la segunda lnea imprime el array resultante.

Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand
Harry Trump,Fred Barney,Helen Rigby,Bill Abel,Chris Hand

Devolviendo un nmero limitado de divisiones

El el siguiente ejemplo, split busca 0 o ms espacios en una cadena y devuelve las tres primeras divisiones que encuentra.

var miCadena = "Hola Mundo. Cmo ests hoy?";
var divisiones = miCadena.split(" ", 3);

print(divisiones);

Este script muestra lo siguiente:

Hola,Mundo.,Cmo

Parntesis de captura

Si el separador contiene parntesis de capturaI los resultados que concuerden son devueltos en el array.

var miCadena = "Hola 1 mundo. Oracin nmero 2.";
var division = miCadena.split(/(\d)/);

console.log(division);

Este script muestra lo siguiente:

Hola ,1, mundo. Oracin nmero ,2,.

Dar la vuelta a una cadena usando split()

var str = "asdfghjkl";
var strReverse = str.split("").reverse().join(""); // 'lkjhgfdsa'
// split() retorna un array en el cual reverse() y join() pueden ser aplicados

Extra: usar el operador === para verificar si la cadena anterior era un palndromo.

Especificaciones

Compatibilidad con navegadores

Ver tambin

• String.prototype.charAt()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()
• Array.prototype.join()