match (Método)

Actualización: noviembre 2007

Ejecuta una búsqueda en una cadena mediante un modelo de expresión regular y devuelve una matriz que contiene los resultados de la búsqueda.

function match(rgExp : RegExp) : Array

Argumentos

• rgExp
  Necesario. Instancia de un objeto Regular Expression que contiene el modelo de expresión regular y los indicadores aplicables. También puede ser un nombre de variable o un literal de cadena que contenga el modelo de expresión regular y los indicadores.

Comentarios

Si el método match no encuentra ninguna coincidencia, devuelve null. Si encuentra una coincidencia, el método match devuelve una matriz y las propiedades del objeto global RegExp se actualizan para reflejar los resultados de la búsqueda.

La matriz devuelta por el método match tiene tres propiedades: input, index y lastIndex. La propiedad input contiene la cadena completa en la que se busca. La propiedad index contiene la posición de la subcadena encontrada dentro de la cadena completa en la que se busca. La propiedad lastIndex contiene la posición siguiente al último carácter de la última coincidencia.

Si no se establece el indicador global (g), el elemento cero de la matriz contiene toda la coincidencia, mientras que los elementos del 1 al n contienen las coincidencias secundarias que se hayan encontrado dentro de la coincidencia. El comportamiento es idéntico al del método exec sin el establecimiento del indicador global. Si se establece el indicador global, los elementos del 0 al n contienen todas las coincidencias que se hayan encontrado.

Ejemplo

En el siguiente ejemplo se muestra el uso del método match.

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 ejemplo muestra el uso del método match con el indicador g establecido.

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".
}

Las siguientes líneas de código muestran el uso de un literal de cadena con el método match.

var r, re = "Spain";
r = "The rain in Spain".replace(re, "Canada");

Requisitos

Versión 3

Se aplica a:

String (Objeto)

Vea también

Referencia

exec (Método)

RegExp (Objeto)

replace (Método)

search (Método)

test (Método)