Método exec

Executa uma Pesquisar em uma seqüência de caracteres usando um padrão de expressão regular e retorna uma matriz contendo os resultados da Pesquisar.

function exec(str : String) : Array

Argumentos

  • str
    Obrigatório.The String o objeto ou string literal na qual deseja executar a Pesquisar.

Comentários

Se o exec método não encontrar uma correspondência, ele retorna null. Se ele encontrar uma correspondência, exec Retorna uma matriz e as propriedades do global RegExp objeto são atualizados para refletir os resultados da correspondência. Zero de elemento da matriz contém a correspondência toda, enquanto os elementos 1 – n contêm qualquer subcorrespondentes ocorridas a correspondência.Esse comportamento é idêntico ao comportamento do match método sem o sinalizar global (g) conjunto.

Se o sinalizar global estiver conjunto para uma expressão regular, exec procura o início da seqüência de caracteres na posição indicada pelo valor do lastIndex. Se o sinalizar global não estiver definido, exec ignora o valor de lastIndex e pesquisas do início da seqüência de caracteres.

A matriz retornada pelo exec método tem três propriedades entrada, índice and lastIndex. The entrada propriedade contém a seqüência de caracteres pesquisada inteira.The índice propriedade contém a posição da substring correspondida dentro da seqüência de caracteres pesquisada completa.The lastIndex propriedade contém a posição após o último caractere na coincidência.

Exemplo

O exemplo a seguir ilustra o uso do exec método:

function RegExpTest() {
   var s = "";
   var src = "The rain in Spain falls mainly in the plain.";
   // Create regular expression pattern for matching a word.
   var re = /\w+/g;
   var arr;
   // Loop over all the regular expression matches in the string.
   while ((arr = re.exec(src)) != null)
      s += arr.index + "-" + arr.lastIndex + "\t" + arr + "\n";
   return s;
}

Requisitos

Versão 3

Aplica-se ao:

Objeto de expressão regular

Consulte também

Conceitos

Sintaxe de Expressãosões regulares

Referência

corresponde ao método

Objeto RegExp

Método de Pesquisar

método de teste