multiline, propriété

Article
08/21/2008

Mise à jour : novembre 2007

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

rgExp.multiline

Arguments

rgExp
Obligatoire. Instance d'un objet Regular Expression.

Notes

La propriété multiline est en lecture seule et retourne la valeur true si l'indicateur multiline est défini pour une expression régulière, ou la valeur false dans le cas contraire. La propriété multiline prend la valeur true si l'objet de l'expression régulière a été créé à l'aide de l'indicateur m. La valeur par défaut est false.

Si multiline prend la valeur false, « ^ » correspond à la position en début de chaîne et « $ » à celle qui se trouve en fin de chaîne. Si multiline a la valeur true, « ^ » correspond à la position en début de chaîne ainsi qu'à la position qui suit un caractère « \n » ou « \r ». « $ » correspond à la position en fin de chaîne et à celle qui précéde un caractère « \n » ou « \r ».

Exemple

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

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