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.

rgExp.exec(cadena) 

Argumentos

rgExp

Requerido. Una instancia de un objeto Regular Expression que contiene el patrón de la expresión regular y los indicadores aplicables.

cadena

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

Comentarios

Si el método exec no encuentra una coincidencia, devuelve null. Si encuentra una coincidencia, el método exec devuelve una matriz, y las propiedades del objeto RegExp se actualizan para reflejar los resultados de la búsqueda. 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 match sin el indicador global (g).

Si se establece el identificador global para una expresión regular, exec busca la cadena empezando en la posición indicada por el valor de lastIndex. Si no se establece el identificador global, exec omite el valor de lastIndex y busca desde el principio de la cadena.

La matriz devuelta por el método exec 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 búsqueda.

Ejemplo

El siguiente ejemplo muestra el uso del método exec:

function ProbarRegExp(){
  var ver = Number(ScriptEngineMajorVersion() + "." + ScriptEngineMinorVersion())
  if (ver >= 5.5){                 //Probar versión de JScript.
    var src = "the rain in Spain falls mainly in the plain.";
    var expRe = /\w+/g;               //Crea patrón de expresión regular.
    var matriz;
    while ((matriz = expRe.exec(src)) != null)
       document.write(matriz.index + "-" + matriz.lastIndex + "\t" + matriz);
  }
  else{
    alert("Necesita una versión más reciente de JScript para este trabajo");
  }
}

Requisitos

Versión 3

Consulte también

Método match | Objeto RegExp | Métodos del objeto Regular Expression | Propiedades del objeto Regular Expression | Sintaxis de expresión regular | Método search | Método test

Se aplica a: Objeto Regular Expression