Referencia de JavaScript 1.5:Objetos globales:String:substring

De MDC

Tabla de contenidos 1 Resumen 2 Sintaxis 3 Parámetros 4 Descripción 5 Ejemplos 5.1 Ejemplo: Usando substring 5.2 Ejemplo: Reemplazar una subcadena dentro de una cadena 6 Vea También

[editar] Resumen

Devuelve un subconjunto de un objeto String.

Método de String
Implementado en:	JavaScript 1.0, NES2.0
Versión ECMA:	ECMA-262

[editar] Sintaxis

substring(indiceA, [indiceB])

[editar] Parámetros

indiceA 

Un entero entre 0 y la longitud de la cadena menos 1.

indiceB 

(opcional) Un entero entre 0 y la longitud de la cadena.

[editar] Descripción

substring extrae caracteres desde indiceA hasta indiceB sin incluirlo. En particular:

• Si indiceA es igual a indiceB, substring devuelve una cadena vacía.
• Si se omite el indiceB, substring extrae caracteres hasta el final de la cadena.
• Si el argumento es menor que 0 o es NaN, se trata como si fuese 0.
• Si el argumento es mayor que nombreCadena.length, se trata como si fuese nombreCadena.length.

Si indiceA es mayor que indiceB, entonces el efecto de substring es como si los dos argumentos se intercambiasen; por ejemplo, cadena.substring(1, 0) == cadena.substring(0, 1).

[editar] Ejemplos

[editar] Ejemplo: Usando substring

El siguiente ejemplo usa substring para mostrar caracteres de la cadena "Mozilla":

// asume una función print ya definida
var cualquierCadena = "Mozilla";

// Muestra "Moz"
print(cualquierCadena.substring(0,3));
print(cualquierCadena.substring(3,0));

// Muestra "lla"
print(cualquierCadena.substring(4,7));
print(cualquierCadena.substring(7,4));

// Muestra "Mozill"
print(cualquierCadena.substring(0,6));

// Muestra "Mozilla"
print(cualquierCadena.substring(0,7));
print(cualquierCadena.substring(0,10));

[editar] Ejemplo: Reemplazar una subcadena dentro de una cadena

El siguiente ejemplo reemplaza una subcadena dentro de una cadena. Reemplazará tanto caracteres individuales como subcadenas. La llamada de la función al final del ejemplo cambia la cadena "Bravo Nuevo Mundo" por "Bravo Nueva Web".

function reemplazarCadena(cadenaVieja, cadenaNueva, cadenaCompleta) { // Reemplaza cadenaVieja por cadenaNueva en cadenaCompleta

   for (var i = 0; i < cadenaCompleta.length; i++) {
      if (cadenaCompleta.substring(i, i + cadenaVieja.length) == cadenaVieja) {
         cadenaCompleta= cadenaCompleta.substring(0, i) + cadenaNueva + cadenaCompleta.substring(i + cadenaVieja.length, cadenaCompleta.length);
      }
   }
   return cadenaCompleta;
}

reemplazarCadena("Mundo", "Web", "Bravo Nuevo Mundo");

[editar] Vea También

substr