global, propriété

Article
08/21/2008

Mise à jour : novembre 2007

Retourne une valeur booléenne indiquant l'état de l'indicateur global (g) utilisé dans une expression régulière.

rgExp.global

Arguments

rgExp
Obligatoire. Instance d'un objet Regular Expression.

Notes

La propriété global est en lecture seule et retourne la valeur true si l'indicateur global est défini pour une expression régulière, ou la valeur false dans le cas contraire. La valeur par défaut est false.

L'indicateur global, lorsqu'il est utilisé, indique qu'une recherche doit trouver toutes les occurrences du modèle spécifié dans la chaîne recherchée, et non pas la première uniquement. On parle aussi de correspondance globale.

Exemple

L'exemple ci-dessous illustre l'utilisation de la propriété global.

function RegExpPropDemo(re : RegExp) {
   print("Regular expression: " + re);
   print("global:     " + re.global);
   print("ignoreCase: " + re.ignoreCase);
   print("multiline:  " + re.multiline);
   print();
};

// Some regular expression to test the function.
var re1 : RegExp = new RegExp("the","i");  // Use the constructor.
var re2 = /\w+/gm;                         // Use a literal.
RegExpPropDemo(re1);
RegExpPropDemo(re2);
RegExpPropDemo(/^\s*$/im);

Le résultat généré par ce programme est le suivant :

Regular expression: /the/i
global:     false
ignoreCase: true
multiline:  false

Regular expression: /\w+/gm
global:     true
ignoreCase: false
multiline:  true

Regular expression: /^\s*$/im
global:     false
ignoreCase: true
multiline:  true