exec (Método)
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 exec(str : String) : Array
Argumentos
- str
Obligatorio. Objeto String o literal de cadena donde se realizará la búsqueda.
Comentarios
Si el método exec no encuentra ninguna coincidencia, devuelve null. Si encuentra una coincidencia, el método exec devuelve una matriz y las propiedades del objeto global RegExp se actualizan para reflejar los resultados de la búsqueda. El elemento cero de la matriz contiene toda la coincidencia, mientras que los elementos 1 a n contienen subcoincidencias que se producen dentro de la coincidencia. El comportamiento es idéntico al del método match sin establecer la marca global (g).
Si se establece la marca global para una expresión regular, el método exec busca la cadena empezando en la posición indicada por el valor de lastIndex. Si no se establece la marca 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 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 posterior al último carácter de la coincidencia.
Ejemplo
En el siguiente ejemplo se muestra el uso del método exec:
var src = "The quick brown fox jumps over the lazy dog.";
// Create regular expression pattern with a global flag.
var re = /\w+/g;
// Get the next word, starting at the position of lastindex.
var arr;
while ((arr = re.exec(src)) != null)
{
print (arr.index + "-" + arr.lastIndex + " " + arr[0]);
}
// Output:
// 0-3 The
// 4-9 quick
// 10-15 brown
// 16-19 fox
// 20-25 jumps
// 26-30 over
// 31-34 the
// 35-39 lazy
// 40-43 dog