Skip to main content

Visit Mozilla.org

Referencia de JavaScript 1.5:Objetos globales:String:split

De MDC


Tabla de contenidos

[editar] Resumen

Divide un objeto String en un arreglo (vector) de cadenas mediante la separación de la cadena en subcadenas.

Método de String
Implementado en: JavaScript 1.1, NES2.0
Versión ECMA: ECMA-262 (si el separador es una cadena)
ECMA-262, Edición 3 (si el separador es una expresión regular)

[editar] Sintaxis

split([separador][, limite])

[editar] Parámetros

separador 
Especifica el carácter a usar para la separación de la cadena. El separador es tratado como una cadena o como una expresión regular. Si se omite el separador, el arreglo devuelto contendrá un sólo elemento con la cadena completa.
limite 
Entero que especifica un límite sobre el número de divisiones a realizar.

[editar] Descripción

El método split devuelve el nuevo arreglo.

Cuando se encuentra, el separador es eliminado de la cadena y las subcadenas obtenidas se devuelven en un arreglo. Si se omite el separador, el arreglo contendrá un único elemento con la cadena original completa.

Note: Cuando la cadena está vacía, split devuelve un arreglo que contiene una cadena vacía, en vez de un arreglo vacío.

[editar] Ejemplos

[editar] Ejemplo: Usando split

El siguiente ejemplo define una función que divide una cadena en un arreglo de cadenas usando el separador especificado. Después de la división de la cadena, la función muestra mensajes indicando la cadena original (antes de la división), el separador usado, el número de elementos del arreglo y los elementos individuales del arreglo. 

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

   for (var i=0; i < arregloDeCadenas.length; i++) {
      document.write(arregloDeCadenas[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 arreglo tiene diez 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 arreglo 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 arreglo tiene 12 elementos: Jan / Feb / Mar / Apr / May / Jun / Jul / Aug / Sep / Oct / Nov / Dec /

[editar] Ejemplo: Eliminar espacios de una cadena

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

<script type="text/javascript">
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);
</script>

Esto imprime dos líneas; la primera línea imprime la cadena original, y la segunda línea imprime el arreglo resultante. 

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

[editar] Ejemplo: Devolviendo un número limitado de divisiones

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

var miCadena = "Hola Mundo. Cómo estás hoy?";
var divisiones = miCadena.split(" ", 3);
document.write(divisiones);

Este script muestra lo siguiente: 

["Hola", "Mundo.", "Cómo"]

[editar] Vea También

charAt, indexOf, lastIndexOf, Array:join

Obtenido de "http://developer.mozilla.org/es/docs/Referencia_de_JavaScript_1.5:Objetos_globales:String:split"