multiline 属性

返回 Boolean 值，指出正则表达式使用的 multiline 标志(m)的状态。默认值为 false。只读。

rgEXP.multiline

必选项 rgExp 参数为 RegExp 对象。

说明

假如正则表达式设置了 multiline 标志，那么 multiline 属性返回 true，否则返回 false。假如创建正则表达式对象时使用了 m 标志，那么 multiline 属性就是 true。

假如 multiline 为 false，那么 "^" 匹配字符串的开始位置，而 "$" 匹配字符串的结束位置。假如 multline 为 true，那么 "^" 匹配字符串开始位置以及 "\n" 或 "\r" 之后的位置，而 "$" 匹配字符串结束位置以及 "\n" 或 "\r" 之前的位置。

示例

以下示例演示了 multiline 属性的特征。假如将 "m" 传递给下面所示的函数，单词 "while" 将被替换为 "and"。这是因为设置了 multiline 标志且 "while" 出现在换行字符的下一行的开始位置。multiline 标志答应在多行的字符串中进行查找。

本函数返回一个字符串以及一个表，表中显示了答应使用的正则表达式标志（g、i 和 m）的状态。它还返回经过所有替换操作的字符串。

function RegExpPropDemo(flag){

if (flag.match(/[^gim]/)) //检查标志的有效性。

return("Flag specified is not valid");

var r, re, s //声明变量。

var ss = "The man hit the ball with the bat.";

ss += "\nwhile the fielder caught the ball with the glove.";

re = new RegExp("^while",flag); //指定要查找的样式。

r = ss.replace(re, "and"); //用 "a" 替换 "the"。

s = "Regular Expression property values:\n\n"

s += "global ignoreCase multiline\n"

if (re.global) //测试 global 标志。

s += " True ";

else

s += "False ";

if (re.ignoreCase) //测试 ignoreCase 标志。

s += " True ";

else

s += "False ";

if (re.multiline) //测试 multiline 标志。

s += " True ";

else

s += " False ";

s += "\n\nThe resulting string is:\n\n" + r;

return(s); //返回替换的字符串。

}

要求

版本 5.5

请参阅

global 属性 ignoreCase 属性 正则表达式语法

应用于：RegExp 对象