corresponde ao método
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 match(rgExp : RegExp) : Array
Argumentos
- rgExp
Obrigatório.Uma instância de um Expressões regulares objeto contendo 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 global RegExp objeto são atualizados para refletir os resultados da correspondência.
A matriz retornada pelo match 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 última coincidência.
Se o sinalizar global (g) não é conjunto, 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 exec método sem o sinalizar global conjunto. Se o sinalizar global estiver conjunto, 0- elementosn contêm todas as correspondências que ocorreu.
Exemplo
O exemplo a seguir ilustra o uso do match método.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/i; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return first occurrence of "ain".
}
Este exemplo ilustra o uso do método correspondência com o g sinalizar definido.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/ig; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return array containing all four
// occurrences of "ain".
}
As linhas de código a seguir ilustram o uso de uma seqüência de caracteres literal com o match método.
var r, re = "Spain";
r = "The rain in Spain".replace(re, "Canada");
Requisitos
Aplica-se ao:
Objeto de seqüência de caracteres