Share via


multiline, propriété

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 suivant illustre le comportement de la propriété multiline. Si vous passez m à la fonction indiquée ci-dessous, le mot « while » est remplacé par le mot « and ». Cela est dû au fait que l'indicateur multiline est défini et que le mot « while » figure au début de la ligne après un caractère de saut de ligne. L'indicateur multiline permet d'exécuter la recherche sur des chaînes multilignes.

function RegExpMultilineDemo(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 ss = "The man hit the ball with the bat ";
    ss += "\nwhile the fielder caught the ball with the glove.";

    // Replace "while" with "and".
    var re = new RegExp("^while", flag);
    var r = ss.replace(re, "and");

    // Output the multiline flag and the resulting string.
    var s = "";
    s += "Result for multiline = " + re.multiline.toString();
    s += ": " + r;

    return(s);
}

print (RegExpMultilineDemo("m"));
print (RegExpMultilineDemo(""));

Configuration requise

Version 5.5

S'applique à :

Regular Expression, objet

Voir aussi

Référence

global, propriété

ignoreCase, propriété

Concepts

Syntaxe d'une expression régulière