Método de EXEC

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

function exec(str : String) : Array

Argumentos

  • str
    Obrigatório. O String objeto ou seqüência de caracteres literal no qual executar a pesquisa.

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 modelo global da RegExp objeto são atualizados para refletir os resultados de correspondência. Zero de elemento da matriz contém a correspondência de toda, enquanto os elementos 1 – n contém qualquer subcorrespondentes ocorridas a correspondência. Esse comportamento é idêntico ao comportamento da match método sem o sinalizador global (g) definida.

Se o sinalizador global estiver definido para uma expressão regular, exec pesquisas a seqüência iniciando na posição indicada pelo valor do lastIndex. Se o sinalizador global não estiver definido, exec ignora o valor de lastIndex e pesquisas desde o início da string.

A matriz retornada pela exec método tem três propriedades, entrada, índice e lastIndex. O entrada propriedade contém a seqüência inteira de pesquisado. O índice propriedade contém a posição da substring correspondida dentro da seqüência completa de pesquisado. O lastIndex propriedade contém a posição após o último caractere na correspondência.

Exemplo

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

var src = "The quick brown fox jumps over the lazy dog.";

// Create regular expression pattern with a global flag.
var re = /\w+/g;

// Get the next word, starting at the position of lastindex.
var arr;
while ((arr = re.exec(src)) != null)
{
    print (arr.index + "-" + arr.lastIndex + " " + arr[0]);
}

// Output:
//  0-3 The
//  4-9 quick
//  10-15 brown
//  16-19 fox
//  20-25 jumps
//  26-30 over
//  31-34 the
//  35-39 lazy
//  40-43 dog

Requisitos

Versão 3

Se aplica A:

Objeto de expressão regular

Consulte também

Referência

corresponde ao método

Objeto RegExp

Método de pesquisa.

Método de teste.

Conceitos

Sintaxe de expressão regular