ignoreCase, propriété

Article
08/21/2008

Mise à jour : novembre 2007

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

rgExp.ignoreCase

Arguments

rgExp
Obligatoire. Instance d'un objet Regular Expression.

Notes

La propriété ignoreCase est en lecture seule et retourne la valeur true si l'indicateur ignoreCase 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 ignoreCase, lorsqu'il est utilisé, précise qu'une recherche ne doit pas faire la distinction entre les majuscules et les minuscules lors de la comparaison avec le modèle dans la chaîne recherchée.

Exemple

L'exemple suivant illustre l'utilisation de la propriété ignoreCase.

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