corresponde ao método
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 match(rgExp : RegExp) : Array
Argumentos
- rgExp
Obrigatório. Uma instância de um A expressão Regular objeto que contém o padrão de expressão regular e sinalizadores aplicáveis. Também pode ser um nome de variável ou uma seqüência literal que contém o padrão de expressão regular e sinalizadores.
Comentários
Se o match método não encontrar uma correspondência, ele retorna null. Se ele encontrar uma correspondência, match retorna uma matriz e as propriedades do modelo global da RegExp objeto são atualizados para refletir os resultados de correspondência.
A matriz retornada pela match 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 última correspondência.
Se o sinalizador global (g) não é definido, o zero de elemento da matriz contém a correspondência de toda, enquanto os elementos 1 através de n contém qualquer subcorrespondentes ocorridas a correspondência. Esse comportamento é idêntico ao comportamento da Método de EXEC quando o sinalizador global não está definido no método. Se o sinalizador global estiver definido, elementos de 0 a n contêm todas as correspondências que ocorreu.
Exemplo
O exemplo a seguir ilustra o uso da match método quando o sinalizador global (g) não está definido.
var src = "Please send mail to george@contoso.com and someone@example.com. Thanks!";
// Create a regular expression to search for an e-mail address.
// The global flag is not included.
// (More sophisticated RegExp patterns are available for
// matching an e-mail address.)
var re = /(\w+)@(\w+)\.(\w+)/;
var result = src.match(re);
// Because the global flag is not included, the entire match is
// in array element 0, and the submatches are in elements 1 through n.
print(result[0]);
for (var index = 1; index < result.length; index++)
{
print("submatch " + index + ": " + result[index]);
}
// Output:
// george@contoso.com
// submatch 1: george
// submatch 2: contoso
// submatch 3: com
Este exemplo ilustra o uso da match método quando o sinalizador global (g) é definido.
var src = "Please send mail to george@contoso.com and someone@example.com. Thanks!";
// Create a regular expression to search for an e-mail address.
// The global flag is included.
var re = /(\w+)@(\w+)\.(\w+)/g;
var result = src.match(re);
// Because the global flag is included, the matches are in
// array elements 0 through n.
for (var index = 0; index < result.length; index++)
{
print(result[index]);
}
// Output:
// george@contoso.com
// someone@example.com
Linhas de código a seguir ilustram o uso de uma seqüência de caracteres literal com o match método.
var re = /th/i;
var result = "through the pages of this book".match(re);