global, propriété
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 suivant illustre l'utilisation de la propriété global. Si vous passez g à la fonction indiquée ci-dessous, toutes les instances du mot « the » sont remplacées par le mot « a ». Notez que l'instance « The » figurant au début de la chaîne n'est pas remplacée car l'indicateur i (ignorer la casse) n'est pas passé à la fonction.
Cette fonction affiche les valeurs Boolean associées aux indicateurs d'expression régulière autorisés, qui sont g, i et m. La fonction affiche également la chaîne dans laquelle tous les remplacements ont été effectués.
function RegExpPropDemo(flag){
// The flag parameter is a string that contains
// g, i, or m. The flags can be combined.
// Check flags for validity.
if (flag.match(/[^gim]/))
{
return ("Flag specified is not valid");
}
// Create the string on which to perform the replacement.
var orig = "The batter hit the ball with the bat ";
orig += "and the fielder caught the ball with the glove.";
// Replace "the" with "a".
var re = new RegExp("the", flag);
var r = orig.replace(re, "a");
// Output the resulting string and the values of the flags.
print ("global: " + re.global.toString());
print ("ignoreCase: " + re.ignoreCase.toString());
print ("multiline: " + re.multiline.toString());
print ("Resulting String: " + r);
}
RegExpPropDemo("g");
Le résultat se présente comme suit :
global: true
ignoreCase: false
multiline: false
Resulting String: The batter hit a ball with a bat and a fielder caught a ball with a glove.