String.prototype.substring()

Sintaxe

str.substring(indexStart[, indexEnd])

Parmetros

indexStart

Um inteiro entre 0 e o comprimento da string (str.length), especificando a posio na string do primeiro caractere a ser includo na substring retornada.

indexEnd

Opcional. Um inteiro entre 0 e o comprimento da string (str.length), especificando a posio na string do primeiro caractere a no ser mais includo na substring retornada.

Valor retornado

Uma nova string contendo a parte especificada da string fornecida.

Descrio

substring() extrai caracteres desde indexStart at, mas no incluindo, indexEnd. Em particular:

• Se indexStart igual a indexEnd, substring() retorna uma string vazia.
• Se indexEnd for omitido, substring() extrai caracteres at o fim da string.
• Se qualquer argumento for menor que 0 ou NaN, ele ser tratado como 0.
• Se qualquer argumento for maior que stringName.length, ele ser tratado como se fosse stringName.length

Se indexStart for maior que indexEnd, ento o efeito do substring() como se os dois argumentos estivessem trocados, por exemplo, str.substring(1, 0) == str.substring(0, 1).

Exemplos

Usando substring()

O seguinte exemplo usa substring() para mostrar caracteres da palavra 'Mozilla':

var anyString = "Mozilla";

// Mostra "Moz"
console.log(anyString.substring(0, 3));
console.log(anyString.substring(3, 0));

// Mostra "lla"
console.log(anyString.substring(4, 7));
console.log(anyString.substring(7, 4));

// Mostra "Mozill"
console.log(anyString.substring(0, 6));

// Mostra "Mozilla"
console.log(anyString.substring(0, 7));
console.log(anyString.substring(0, 10));

Usando substring() com length

O exemplo a seguir usa o mtodo substring() e a propriedade length para extrair os ltimos caracteres de uma string especfica. Este mtodo pode ser mais fcil de lembrar, visto que voc no precisa saber os ndices inicial e final como faria nos exemplos acima.

// Mostra 'illa', os ltimos 4 caracteres
let anyString = "Mozilla";
let anyString4 = anyString.substring(anyString.length - 4);
console.log(anyString4);

// Mostra 'zilla', os ltimos 5 caracteres
let anyString = "Mozilla";
let anyString5 = anyString.substring(anyString.length - 5);
console.log(anyString5);

A diferena entre substring() e substr()

H uma diferena sutil entre os mtodos substring() e substr(), ento voc deve ter cuidado para no confundi-los.

Os argumentos de substring() representam os ndices inicial e final, enquanto os argumentos de substr() representam o ndice inicial e o nmero de caracteres a serem includos na string retornada.

Alm disso, substr() considerado um recurso legacy no ECMAScript e pode ser removido em verses futuras, portanto, melhor evitar us-lo, se possvel.

let text = "Mozilla";
console.log(text.substring(2, 5)); // retorna "zil"
console.log(text.substr(2, 3)); // retorna "zil"

Diferenas entre substring() e slice()

Os mtodos substring() e slice() so quase idnticos, mas existem algumas diferenas sutis entre os dois, especialmente na forma como os argumentos negativos so tratados.

O mtodo substring() troca seus dois argumentos se indexStart for maior que indexEnd, o que significa que uma string ainda ser retornada. O mtodo slice() retorna uma string vazia caso o mesmo ocorra.

let text = "Mozilla";
console.log(text.substring(5, 2)); // retorna "zil"
console.log(text.slice(5, 2)); // retorna ""

Se um ou ambos os argumentos forem negativos ou NaN, o mtodo substring() os tratar como se fossem 0.

console.log(text.substring(-5, 2)); // retorna "Mo"
console.log(text.substring(-5, -2)); // retorna ""

slice() tambm trata os argumentos NaN como 0, mas quando recebe valores negativos, ele conta regressivamente a partir do final da string para encontrar os ndices.

console.log(text.slice(-5, 2)); // retorna ""
console.log(text.slice(-5, -2)); // retorna "zil"

Veja a pgina slice() para mais exemplos com nmeros negativos.

Substituindo uma substring() com uma string

O seguinte exemplo substitui uma substring dentro de uma string. Ela ir substituir ambos caracteres e substrings individualmente. A funo invocada na linha final do exemplo altera a string "Brave New World" para "Brave New Web".

function replaceString(oldS, newS, fullS) {
  // Substitui oldS por newS na string fullS
  for (var i = 0; i < fullS.length; i++) {
    if (fullS.substring(i, i + oldS.length) == oldS) {
      fullS =
        fullS.substring(0, i) +
        newS +
        fullS.substring(i + oldS.length, fullS.length);
    }
  }
  return fullS;
}

replaceString("World", "Web", "Brave New World");

Note que isto pode resultar em um loop infinito se oldS for um substring de newS por exemplo, se voc tentou substituir "World" com "OtherWorld". O melhor mtodo para substituir strings o seguinte:

function replaceString(oldS, newS, fullS) {
  return fullS.split(oldS).join(newS);
}

O cdigo acima serve como um exemplo para operaes com substring. Se voc precisa substituir substrings, na maioria das vezes voc vai querer usar String.prototype.replace().

Especificaes

Navegadores compatveis

Veja tambm

• String.prototype.substr()
• String.prototype.slice()