exec, méthode
Exécute une recherche sur une chaîne à l'aide d'un modèle d'expression régulière et retourne, sous forme de tableau, les résultats de cette recherche.
function exec(str : String) : Array
Arguments
- str
Obligatoire. Objet String ou littéral de chaîne sur lequel s'effectue la recherche.
Notes
Si la méthode exec ne trouve aucune correspondance, elle retourne la valeur null. Dans le cas contraire, exec retourne un tableau, et les propriétés de l'objet RegExp global sont mises à jour pour refléter les résultats de la recherche. L'élément zéro du tableau contient la chaîne correspondante intégrale ; les éléments 1 – n contiennent les sous-chaînes trouvées à l'intérieur de la correspondance. Ce comportement est identique à celui de la méthode match pour laquelle l'indicateur global (g) n'a pas été défini.
Si ce dernier est défini pour une expression régulière, la méthode exec recherche la chaîne débutant à la position indiquée par la valeur de la propriété lastIndex. Si l'indicateur global n'est pas défini, exec ignore la valeur de la propriété lastIndex et effectue la recherche à partir du début de la chaîne.
Le tableau retourné par la méthode exec possède trois propriétés, à savoir input, index et lastIndex. La propriété input contient la chaîne recherchée dans son intégralité. La propriété index contient la position de la sous-chaîne trouvée à l'intérieur de la chaîne recherchée complète. La propriété lastIndex contient la position suivant le dernier caractère de la correspondance.
Exemple
L'exemple suivant illustre l'utilisation de la méthode 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