exec, méthode

Article
08/21/2008

Mise à jour : novembre 2007

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 ci-dessous illustre l'utilisation de la méthode exec :

function RegExpTest() {
   var s = "";
   var src = "The rain in Spain falls mainly in the plain.";
   // Create regular expression pattern for matching a word.
   var re = /\w+/g;
   var arr;
   // Loop over all the regular expression matches in the string.
   while ((arr = re.exec(src)) != null)
      s += arr.index + "-" + arr.lastIndex + "\t" + arr + "\n";
   return s;
}