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

objetoString.match(rgExp)

Argumentos

objetoString

Requerido. El objeto String o literal en el que se realiza la búsqueda.

rgExp

Requerido. Una instancia de un objeto Regular Expression que contiene el patrón de la expresión regular y los indicadores aplicables. También puede ser un nombre de variable o literal de cadena que contenga un patrón de expresión regular e indicadores.

Comentarios

Si el método match no encuentra una coincidencia, devuelve null. Si encuentra una coincidencia, el método match devuelve una matriz, y las propiedades del objeto 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 buscada entera. La propiedad index contiene la posición de la subcadena buscada dentro de la cadena entera. La propiedad lastIndex contiene la posición siguiente al último carácter de la última búsqueda.

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

Ejemplo

El siguiente ejemplo muestra el uso del método match.

function EjemploDeMatch(){
   var r, re;         //Declaración de variables.
   var s = "The rain in Spain falls mainly in the plain";
   re = /ain/i;    //Crea patrón de expresión regular.
   r = s.match(re);   //Intenta buscar en la cadena de búsqueda.
   return(r);         //Devuelve la primera aparición de "ain".
}

Este ejemplo muestra el uso del método match con el indicador g.

function EjemploDeMatch(){
   var r, re;         //Declaración de variables.
   var s = "The rain in Spain falls mainly in the plain";
   re = /ain/ig;    //Crea patrón de expresión regular.
   r = s.match(re);   //Intenta buscar en la cadena de búsqueda.
   return(r);         //Devuelve una matriz que contiene
                      // las cuatro ocurrencias de "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

Consulte también

Método exec | Métodos del objeto String | Objeto RegExp | Método replace | Método search | Método test

Se aplica a: Objeto String