返回 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 对象