substr

Resumen

Devuelve los caracteres de una cadena comenzando en la localización especificada, y en el número de caracteres especificado.

Método de String
Implementado en: JavaScript 1.0, JScript 3
Versión ECMA: Ninguna, aunque ECMA-262 ed. 3 tiene una sección no oficial sugiriendo la uniformidad semática para substr

Sintaxis

 var sub = ''string''.substr(''inicio''[, ''longitud'']);

Parámetros

inicio 
Localización en la cual se empieza a extraer caracteres (un entero entre 0 y la longitud de la cadena menos 1).
longitud 
El número de caracteres a extraer.

Descripción

inicio es un índice de un carácter. El índice del primer carácter es 0, y el índice del último carácter es la longitud de la cadena menos 1. substr comienza extrayendo caracteres a partir del inicio y recoge longitud de caracteres (a menos que se alcance el final de la primera cadena, en cuyo caso se devuelven menos).

Si inicio es positivo y es mayor o igual que la longitud de la cadena, substr devuelve una cadena vacía.

Si inicio es negativo, substr lo usa como un índice del carácter desde el final de la cadena. Si inicio es negativo y abs(inicio) es mayor que la longitud de la cadena, substr usa 0 como índice inical. Nota: la manipulación de valores negativos de el argumento inicio no es soportada por Microsoft JScript .

Si longitud es 0 o negativa, substr devuelve una cadena vacía. Si se omite longitud, inicio extrae caracteres hasta el final de la cadena.

Ejemplos

Ejemplo: Usando substr

Considera el siguiente script:

// asume una función print ya definida
var cadena = "abcdefghij";
print("(1,2): "    + cadena.substr(1,2));
print("(-3,2): "   + cadena.substr(-3,2));
print("(-3): "     + cadena.substr(-3));
print("(1): "      + cadena.substr(1));
print("(-20, 2): " + cadena.substr(-20,2));
print("(20, 2): "  + cadena.substr(20,2));

Este script muestra:

(1,2): bc
(-3,2): hi
(-3): hij
(1): bcdefghij
(-20, 2): ab
(20, 2):

 

Vea También

substring

Etiquetas y colaboradores del documento

Colaboradores de esta página: Julien.stuby, Talisker
Última actualización por: Julien.stuby,