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