StringRegExp
检查字串是否匹配指定的正则表达式.
StringRegExp ( "test", "pattern" [, flag = 0 [, offset = 1]] )
参数
test |
要检查的主题字符串 |
pattern |
要匹配的正则表达式. |
flag |
[可选] 表示函数运行方式的值. 见下表说明. 默认 0. |
offset |
[可选] 开始匹配的字符串位置 (起始于1). 默认为 1. |
flag |
值 |
$STR_REGEXPMATCH (0) |
返回 1 (匹配) 或 0 (不匹配). (默认) |
$STR_REGEXPARRAYMATCH (1) |
返回匹配的数组 |
$STR_REGEXPARRAYFULLMATCH (2) |
返回完整匹配的数组 (Perl / PHP 结构) |
$STR_REGEXPARRAYGLOBALMATCH (3) |
返回全局匹配的数组 |
$STR_REGEXPARRAYGLOBALFULLMATCH (4) |
返回完整匹配(Perl/ PHP 结构)的全局匹配数组 |
常量定义在 StringConstants.au3.
返回值
标志 = $STR_REGEXPMATCH (0) :
@error: |
意义 |
2: |
正则表达式错误. @Extended = 正则表达式中的错误偏移量 |
标志 = $STR_REGEXPARRAYMATCH (1) 或 $STR_REGEXPARRAYFULLMATCH (2) :
@error: |
意义 |
0: |
有效数组. 为下一个偏移量检查 @Extended |
1: |
数组无效. 没有匹配项目 |
2: |
正则表达式错误, 数组无效. @Extended = 正则表达式的偏移量错误 |
标志 = $STR_REGEXPARRAYGLOBALMATCH (3) 或 $STR_REGEXPARRAYGLOBALFULLMATCH (4) :
@error: |
意义 |
0: |
有效数组 |
1: |
数组无效. 没有匹配项目 |
2: |
正则表达式错误, 数组无效. @Extended = 正则表达式的偏移量错误 |
备注
标志参数可以有5个值 ($STR_REGEXPMATCH (0) 到 $STR_REGEXPARRAYGLOBALFULLMATCH (4)).
test |
返回 1 (true) 发现匹配; 或 0 (false) 没有匹配 |
$STR_REGEXPARRAYMATCH (1) $STR_REGEXPARRAYFULLMATCH (2) |
找到第一个匹配，返回的捕获组在一个数组中; 当模式没有捕获组, 返回的第一个匹配在数组中 |
$STR_REGEXPARRAYGLOBALMATCH (3) $STR_REGEXPARRAYGLOBALFULLMATCH (4) |
使用匹配的所有实例填充数组 |
$STR_REGEXPARRAYFULLMATCH (2) 与 $STR_REGEXPARRAYGLOBALFULLMATCH (4) 包括完整匹配的文本作为返回数组的第一个元素, $STR_REGEXPARRAYMATCH (1) 与 $STR_REGEXPARRAYGLOBALMATCH (3) 不只是捕获的组.
正则表达式表示法以紧凑方式搜索指定主题字符串，确定可以由 StringRegExp() 提取的匹配部分,
或可以由 StringRegExpReplace() 替换的匹配部分.
更确切的说, 正则表达式引擎将尝试从左到右匹配主题字符串的格式(一种编程格式). 如果发生不匹配, 引擎将尝试回溯到需要的位置(以此返回之前的状态), 以求匹配模式的其余部分.
回溯是正则表达式引擎的基本特征之一, 每个初学者程序员都知道并经常使用. 这就像在离开每个路口时做上标记, 并在遇到死胡同时回到最近一个还没走过的路口: 在你找到正确的点(匹配成功)或探索过所有路径都没有你的目标(匹配失败)之前, 你都需要使用回溯. 这根在目录树中搜索指定的文件名没什么不同.
AutoIt 使用 PCRE 引擎. PCRE 表示 "Perl兼容的正则表达式", 这是最全面的开源引擎. 包含了 Unicode 类别属性(UCP)支持, 它允许大多数人类语言的细节处理.
然而, 为了保持与之前版本的兼容性并保持最佳的匹配速度, 在默认情况下没有启用 UCP. 你可以在表达式最前面添加字符串 (*UCP) 来启用它. 启用时, UCP 设置将更改正则表达式的元素数目扩展, 如下文所述的适用情况.
此页只是摘要表达式最常用的模式元素. 关于 AutoIt 实施正则表达式的全面深入地讨论, 请参阅 PCRE 模式的完整描述.
除非您已熟悉正则表达式, 否则你可能需要不止一次阅读本摘要的几个部分, 以掌握它们如何工作及其之间的相互关系.
注意: 错误的正则表达式可以产生一个无限循环而占用 CPU, 甚至可以导致崩溃.
全局设置
这些设置仅在模式的开始被识别并影响全局范围.
换行符约定
换行符序列影响 ^ 和 $ 的定位匹配, 并确定 \N 和 . 是否匹配.
默认情况下换行符序列是 @CRLF组合或 @CR 或 @LF.
默认值可以通过在表达式的开始添加下列操作来更改.
(*CR) |
回车符 (@CR) |
(*LF) |
换行符 (@LF) |
(*CRLF) |
回车符后紧接换行符 (@CRLF) |
(*ANYCRLF) |
任何 @CRLF, @CR 或 @LF. 这是默认的换行约定 |
(*ANY) |
任何 Unicode 换行符序列: @CRLF, @LF, VT, FF, @CR 或 \x85 |
\R 匹配
(*BSR_ANYCRLF) |
默认 \R 仅匹配 @CRLF, @CR 或 @LF |
(*BSR_UNICODE) |
变形的 \R 匹配任何 Unicode 换行符序列: @CRLF, @LF, VT, FF, @CR 或 \x85 |
PCRE 模式可以包含选项, 这些选项包含在 (? ) 序列中. 选项可以组合在一起: "(?imx)". 选项后跟随一个连字符表示否定: "(?im-sx)".
选项出现在组外将影响剩余模式. 选项在组内则仅影响本组. 选项在字符类内部将失去其特殊含义, 仅代表它们本身.
(?i) |
Caseless: 从该点开始匹配不区分大小写. 默认匹配是区分大小写的. 当启用 UCP 则适用于整个 Unicode 平面 0，默认仅适用于 ASCII 字母 A-Z 与 a-z. |
(?m) |
多行: ^ 与 $ 匹配数据内的换行符. 默认多行是关闭的. |
(?s) |
单行 或 DotAll: . 匹配任何字符, 包括一个换行符序列. 默认 DotAll 是关闭的, 因此 . 不匹配换行符序列. |
(?U) |
Ungreedy: 从该点开始限定符变得懒惰(非贪婪). 默认为贪婪匹配 - 见下文的进一步解释. |
(?x) |
eXtended: 字符类之外的空格将被忽略, # 启动模式到下一个实体换行符的注释. 组件之间的无意义空白使正则表达式有更好的可读性. 默认空格匹配自己并且 # 是原义字符. |
字符
正则表达式模式由需匹配的字面 Unicode 文本部分, 与正则表达式说明符或选项混合组成. 说明符和选项使用一些特殊含义的 元字符. 或引用下表描述的特殊模式元件.
字面文本部分, 文本总是代表它们自身: 模式 "literal part with 中国文字" 将完全匹配字符串 "literal part with 中国文字".
一些非字母数字字符称为 元字符, 具有特殊的行为, 将在后面讨论.
表示字面上某些字符的特殊字符
下面的特殊字符被用来表示字面上某些字符.
\a |
代表 "警钟", 即 BEL 字符 (Chr(7)) |
\cX |
代表 "control-X", 其中 X 是任何 7 位 ASCII 字符. 例如, "\cM" 表示 ctrl-M, 与 \x0D 或 \r (Chr(13)) 相同 |
\e |
代表 "escape" 控制字符 (Chr(27)). 不能与转义字符混为一谈 |
\f |
代表 "换页符" (Chr(12)) |
\n |
代表 "换行符" (@LF, Chr(10)) |
\r |
代表 "回车符" (@CR, Chr(13)) |
\t |
代表 "水平制表符" (@TAB, Chr(9)) |
\ddd |
表示八进制代码字符 ddd, 或反向引用捕获组的十进制数 ddd. 例如, ([a-z])\1 将匹配 2 倍字母. 最好避免使用 因为它可能是不明确的! 有利于下面的十六进制表示 |
\xhh |
代表十六进制的 Unicode 编码字符 hh: "\x7E" 代表一个波浪号 "~" |
\x{hhhh} |
代表十六进制的 Unicode 编码字符 hhhh: "\x{20AC}" 表示欧元符号, "�" (ChrW(0x20AC)) |
\x |
其中 x 为非字母数字, 代表字面原意 x. 从字面上用来表示元字符: "\.\[" 表示一个圆点后跟随一个左方括号, ".[" |
\Q ... \E |
逐字顺序: 元字符在 \Q 与 \E 之间失去特殊含义: "\Q(.)\E" 匹配 "(.)" 并且等效, 但读得更多, "\(\.\)" |
元字符
PCRE 元字符 \ . ^ $ | [ ( { * + ? # 具有一或多个特殊的含义, 取决于具体的环境.
要插入字面原意的元字符, 在前面加上一个反斜杠 (这就所谓 转义(或引用) 字符): "\$" 表示美元字符.
将在单独节段讨论元字符的行为或含义.
字符类型
. |
匹配任何单个字符, 默认除了换行符序列. 当选项 (?s) 激活时匹配换行符 |
\d |
匹配任何十进制数字 (在启用 UCP 的任何语言的任何 Unicode 十进制) |
\D |
匹配任何非数字 |
\h |
匹配任何水平空白字符(见下表) |
\H |
匹配任何不是水平空白符的字符 |
\N |
匹配除换行符序列之外的任何字符, 并忽略选项 (?s) |
\p{ppp} |
仅当 UCP 启用时: 匹配任何 Unicode 属性的字符 ppp. 例如 "\b\p{Cyrillic}+" 匹配任何西里尔语单词; "\p{Sc}" 匹配任何货币符号. 请查看参考文档细节 |
\P{ppp} |
仅当 UCP 启用时: 匹配不具有属性的任何 Unicode 字符 ppp |
\R |
默认匹配任何 Unicode 换行符序列, 或当前处于活动状态的 (*BSR_...) 设置. 默认 \R 匹配 "(?>\r\n|\n|\r)" 其中 "(?>...)" 是一个原子组, 使 "\r\n" (@CRLF) 序列不易破坏 |
\s |
匹配任何空白字符 (见下表) |
\S |
匹配任何非空白字符 |
\v |
匹配任何垂直空白字符 (见下表) |
\V |
匹配不是垂直空白字符的任何字符 |
\w |
匹配任何 "单词" 字符: 任何数字, 任何字母或下划线 "_" (或当 UCP 启用时的任何 Unicode 数字, 任何语言中的任何 Unicode 字母, 下划线 "_") |
\W |
匹配任何非单词字符 |
\X |
仅当 UCP 启用时: 匹配任何 Unicode 扩展的字母群集, 这是一个不易破坏的的代码点序列, 表示用户的一个单独字符. 其结果是 \X 可能在主题字符串中匹配多个字符, 与此表中所有其它序列相反 |
\h 匹配水平空白字符
\h 默认相当于 "[\x09 \xA0]" (或当 UCP 启用时相当于 "[\x09 \xA0\x{1680}\x{180E}\x{2000}-\x{200A}\x{202F}\x{205F}\x{3000}]".)
这个匹配: 水平制表符 (HT), 空白, 非换行空格 (当 UCP 启用时增加: 欧甘文字空间标记, 蒙古文元音分隔符, En quad, Em quad, En space, Em space, Three-per-em space, Four-per-em space, Six-per-em space, Figure space, 标点符号空间, Thin space, Hair space, 窄无中断空格, 中等数学空间, 表意字符空间.)
\v 匹配垂直空白字符
\v 默认情况下等价于 "[\x0A-\x0D]" (或 UCP 启用等价于"[\x0A-\x0D\x{0085}\x{2028}\x{2029}]")
这个匹配: 换行符 (LF), 垂直制表符 (VT), 换页符 (FF), 回车符 (CR) (当 UCP 启用时增加: 下一行 (NEL), 行分隔符, 段落分隔符.)
\s 匹配垂直空白字符
\s 等价于 "[\h\x0A\x0C\x0D]".
这个匹配: 匹配 \h 内的所有字符加换行符(LF), 换页符(FF), 回车符(CR).
匹配 [[:space:]] 空白字符
[[:space:]] 相当于 "\s".
这个匹配: \s 内的所有字符加上垂直制表 (VT).
Character classes and POSIX classes
字符类
字符类定义一组允许的(或不允许的)字符, 希望匹配(或不匹配)主题字符串的下一个字符.
在字符类, 大多数元字符失去意义 (例如 $ . or *) 或表示其它东西 (例如 ^).
[ ... ] |
匹配明确设置的任何字符: "[aeiou]" 匹配任何小写元音字母. 在开始和结束字符之间添加一个连字符可以定义一组连续(递增的 Unicode 码顺序)集合: "[a-z]" 匹配任意小写 ASCII 字母. 要在一组中包括连字符 (-), 将它作为一组的第一个或最后一个字符或转义连字符: \-. 注意模式 "[A-z]" 与模式 "[A-Za-z]" 是不一样的: 前者相当于 "[A-Z\[\\\]^_`a-z]". 若要在一组中包括一个右括号, 将它设置为集合的第一个字符或转义它: "[][]" 与 "[\[\]]" 将匹配 "[" 或 "]". 注意字符类中，只有 \d, \D, \h, \H, \p{}, \P{}, \s, \Q...\E, \S, \v, \V, \w, \W, and \x 序列保留其特殊的含义, 而 \b 表示退格符 (Chr(8)). |
[^ ... ] |
匹配任何 不 在设置中的字符: "[^0-9]" 匹配任何非数字. 要在一组中包括一个脱字符号 (^), 把它放在组的开始后面, 或转义它 (\^). |
POSIX 类
这些被命名的集规格是在字符类中使用它们自己: "[z[:digit:]w-y]" 相同于 "[w-z0-9]". 要否定 POSIX 字符类, 在第一个冒号后放一个脱字符号 (^): "[[:^digit:]]".
当 UCP 启用时, 一些 POSIX 类扩展到一些 Unicode 字符子集, 否则默认限制在 7 位 ASCII 码.
[:alnum:] |
ASCII 字母和数字 (等同于 [^\W_] 或 [A-Za-z0-9]). 当 UCP 启用时: 匹配 Unicode 字母和数字 (等同于 [^\W_] 或 \p{Xan}). |
[:alpha:] |
ASCII 字母 (等同于 [^\W\d_] 或 [A-Za-z]). 当 UCP 启用时: 匹配 Unicode 字母 (等同于 [^\W\d_] 或 \p{L}). |
[:ascii:] |
ASCII 字符 (等同于 [\x00-\x7F]). |
[:blank:] |
空格或制表符 (@TAB) (等同于 \h 或 [\x09\x20]). 当 UCP 启用时: 匹配 Unicode 水平空格 (等同于 \h). |
[:cntrl:] |
ASCII 控制字符 (等同于 Chr(0) ... Chr(31) 与 Chr(127)). |
[:digit:] |
ASCII 十进制数字 (等同于 \d 或 [0-9]). 当 UCP 启用时: Unicode 十进制数字 (等同于 \d or \p{Nd}). |
[:graph:] |
ASCII 打印字符，但不包括空白 (等同于 Chr(33) ... Chr(126)). |
[:lower:] |
ASCII 小写字母 (等同于 [a-z]). 当 UCP 启用时: Unicode 小写字母 (等同于 \p{Ll}). |
[:print:] |
ASCII 打印字符，包括空格 (等同于 Chr(32) ... Chr(126)). |
[:punct:] |
ASCII 标点符号, [:print:] 排除 [:alnum:] 和空白, (33-47, 58-64, 91-96, 123-126). |
[:space:] |
ASCII 空白 (等同于 [\h\x0A-\x0D]). [:space:] 与 \s 不太一样: 它包括 VT, Chr(11)). |
[:upper:] |
ASCII 大写字母 (等同于 [A-Z]). 当 UCP 启用时: Unicode 大写字母 (等同于 \p{Lu}). |
[:word:] |
ASCII "单词" 字符 (等同于 \w 或 [[:alnum:]_]). 当 UCP 启用时: Unicode "单词" 字符 (等同于 \w 或 [[:alnum:]_] 或 \p{Xwd}). |
[:xdigit:] |
十六进制数字 (等同于 [0-9A-Fa-f]). |
组用来分隔子模式和强大的表达式构造块. 组可以有或没有捕获, 并且除注释组之外, 可以不论其类型的嵌套使用. 正则表达式可以包含多达 65535 个捕获组.
选项字母 (如上所述) 可以方便地在非捕获组内插入 "?" 与 ":" 之间: "(?-i:[aeiou]{5})" 匹配 5 个小写元音字母. 此时的选项是本地组.
( ... ) |
捕获组. 组中的元素按顺序处理，并且可以作为一个块重复. 例如 "(ab)+c" 将匹配 "abc" 或 "ababc", 但不匹配 "abac". 捕获组记得它们匹配的文本, 以便用于反向引用, 并且填充(可选)返回的数组. 它们按括号内出现的顺序从 1 开始编号. 捕获组也可以以递归方式被视为其他子程序中的模式. |
(?<name> ... ) |
命名的捕获组. 可以稍后引用的名称，以及数字. 避免使用的名称 "DEFINE" (参阅"有条件模式"). |
(?: ... ) |
非捕获组. 不记录匹配字符到数组中, 不能重新用作反向引用. |
(?| ... ) |
非捕获组与重置. 重置每个顶层的替代方案, 包含捕获组编号: "(?|(Mon)|(Tue)s|(Wed)nes|(Thu)rs|(Fri)|(Sat)ur|(Sun))day" 与平日名称匹配，并捕获组编号 1 的缩写形式. |
(?> ... ) |
原子非捕获组: 锁定并永远不回溯 (归还) 已匹配的 (参阅下面的限定符和贪婪). 原子组, 如所有限定符, 总是贪婪的. |
(?# ... ) |
注释组: 总是被忽略 (但可以不包含一个右括号, 因此注释组不能嵌套). |
限定符 (或重复符) 指定前面的字符, 类, 引用和组预计要匹配多少. 可以选择贪婪限定符如何有效重复的行为方式. 例如 "\d{3,5}" 将匹配至少 3 个和不超过 5 个的十进制数字.
默认模式为 "greedy", 表示量词 * + ? {...} 在不会导致其余模式失败的情况下, 将匹配最长的字符串. 在表达式最前面的 (?U) 选项, 或局部量词后放入一个问号, 贪婪可以倒置整个模式.
非贪婪 (lazy) 重复匹配最小的字符串，仍然允许匹配模式的其余部分. 例如指定主题字符串 "aaab", 并指定表达式 "(a*)([ab]+)" 将捕获 "aaa" 然后是 "b", 但 "(?U)(a*)([ab]+)" 将捕获 "" 然后是 "a": 事实上, 要满足懒惰 "(a*)" 和捕获 "a" 匹配懒惰 "([ab]+)" 子模式, 捕捉一个空字符串是不好的.
所有限定符是原子和贪婪. 其实它们是简单的原子组短表示法. "\d++" 是 "(?>\d+)" 的一个速记符号, 它的行为是 "匹配一个完整序列的一或多个数字, 但没有任何回退". 其结果是 "\d++(\d)" 永远不能匹配, 因为最后一位数字 (粗体字) 已经匹配过, 并且由 "\d++" 锁定. 这是相对简单的贪婪, 其中 "\d+(\d)" 将首先匹配一个完整序列的数字 "\d+", 然后回溯，最后才允许 "(\d)" 捕获它.
使用原子组或占有欲限定符的原因有两个: 要么匹配可能会单独出现的字符序列 (例如 \R 中定义的 "\r\n"), 或为强制在某些情况下获取涉及无限重复的失败结果, 引擎通常会花很长时间试图在失败之前分组数量庞大的组合.
? |
0 或 1, 贪婪 |
?+ |
0 或 1, 占有欲 |
?? |
0 或 1, 懒惰 |
* |
0 或更多, 贪婪 |
*+ |
0 或更多, 占有欲 |
*? |
0 或更多, 懒惰 |
+ |
1 或更多, 贪婪 |
++ |
1 或更多, 占有欲 |
+? |
1 或更多, 懒惰 |
{x} |
精确 x |
{x,y} |
至少 x 并且不超过 y, 贪婪 |
{x,y}+ |
至少 x 并且不超过 y, 占有欲 |
{x,y}? |
至少 x 并且不超过 y, 懒惰 |
{x,} |
x 或更多, 贪婪 |
{x,}+ |
x 或更多, 占有欲 |
{x,}? |
x 或更多, 懒惰 |
X|Y |
可以匹配的子模式 X 或 Y: "ac|dc|ground" 匹配 "ac" 或 "dc" 或 "ground" |
反向引用允许重复使用以前捕获的组的内容.
\n |
引用先前捕获组的绝对数量. 警告: 如果没有组号码 n 存在, 它计算结果值 n 提供 n 是有效的八进制字符值, 否则出现错误. 由于这种模糊性, 这种形式是不推荐的. 下一个安全语义形式会更好 |
\gn |
引用先前捕获组的绝对数量 |
\g{n} |
引用先前捕获组的绝对数量. 与上面类似, 但明确划定 n 的结束位置: 这对于后面的字符存在(是)数字的情况很有用 |
\g-n |
引用先前捕获组的相对数 |
\k<name> |
引用先前捕获组的名称 |
引用子程序
捕获组是可以调用的子模式(可能是递归), 酷似一种编程语言中的子程序. 子模式只是在当前匹配点重新运行. 请参阅参考文档的详细信息和示例.
(?R) 或 (?0) |
递归进入整个正则表达式 |
(?n) |
调用子模式的绝对数 |
(?+n) |
调用子模式的相对数 |
(?-n) |
调用子模式的相对数 |
(?&name) |
按名称调用子模式 |
锚点和断言测试, 不改变匹配位置, 因此没有消耗也不捕获任何东西
锚点测试当前匹配点的位置.
^ |
在字符类之外, 脱字符匹配主题文本的开始, 如果选项 (?m) 激活, 则只是在一个非最终换行符序列的后面. 默认换行序列是 @CRLF. 在字符类的内部, 领先的 ^ 配合类 (不包括那里列出的字符). |
$ |
在字符类之外, 匹配主题文本的末尾, 如果选项 (?m) 激活, 则只是在换行符序列之前. 在字符类的内部, $ 表示本身，一个美元符号. |
\A |
仅在绝对主题字符串的开头匹配, 忽略多行选项 (?m). 如果偏移量不是 1 将永远不会匹配. |
\G |
匹配主题字符串当前位置的第一个匹配项. |
\z |
仅匹配主题字符串的结束, 忽略多行选项 (?m). |
\Z |
仅匹配主题字符串的结束, 或在一个换行符序列结束之前, 忽略多行选项 (?m). |
断言测试前一个字符 (后处理), 当前匹配点在 (单词边界) 或之后 (先行查找).
\b |
匹配 "单词" 的边界, 即字符之间不能同时 \w 或 \W. 参阅 \w 的 "单词" 描述. 在字符类内部, \b 表示 "backspace(退格字符)" (Chr(8)) |
\B |
不匹配单词边界 |
(?=X) |
正向预取: 匹配的子模式 X 匹配当前位置的开始字符 |
(?!X) |
负向预取: 匹配的子模式 X 不匹配当前位置的开始字符 |
(?<=X) |
正向后行: 匹配的子模式 X 匹配当前位置之前的字符. 模式 X 必须匹配固定长度的字符串, 即不能使用任何不确定的量词 * + 或 ? |
(?<!X) |
负向后行: 匹配的子模式 X 不匹配当前位置之前的字符. 模式 X 必须匹配固定长度的字符串, 即不能使用任何不确定的量词 * + 或 ? |
在某些情况下, 为了稍后匹配主题字符串中更多相关数据, "忽略"到当前为止匹配的东西是必要的.
\K |
复位开始匹配在主题字符串的当前点. 请注意，已经捕获的组被丢下不管，仍然填充返回的数组; 因此它总是可以稍后反向引用. \K 的动作相似后处理但不完全相同, 因为 \K 可以工作在不同长度的更替. |
这些构造是类似于 If...EndIf 与 If...Else...EndIf 块.
(?(条件)确定的-模式) |
允许有条件执行的模式. |
(?(条件)确定的-模式|否定的-模式) |
结果取决于 (条件) 的在不同模式之间的选择. |
(n) |
测试绝对数量的捕获组是否与 n 匹配. |
(+n) |
测试相对数量的捕获组是否与 +n 匹配. |
(-n) |
测试相对数量的捕获组是否与 -n 匹配. |
(<name>) |
测试名称捕获组是否与 name 匹配. |
(R) |
测试是否发生任何种类的递归. |
(Rn) |
测试最近递归捕获组绝对数量是否为 n. |
(R&name) |
测试最近递归捕获组名称是否为 name. |
(DEFINE) |
如果不使用 否定的-模式, 允许其它地方定义的可用子程序. "(?x) (?(DEFINE) (?<byte> 2[0-4]\d | 25[0-5] | 1\d\d | [1-9]?\d) )" 定义一个名为 "byte" 的子程序, 匹配一个 IPv4 地址的任何组件. 实际地址可由 "\b (?&byte) (\.(?&byte)){3} \b" 匹配. |
(断言) |
这里的 断言 是正数或负数, 断言为预取或或后处理之一. |
这些选项, 只是简单提到了转义和结构; 何时以及如何使用它们的详细信息请参见参考文档.
优秀的设置和选项
(?J) |
允许重复的组或子程序名称 (这里不再进一步讨论) |
(?X) |
导致某些语境序列引发错误, 而不是良性的 |
(*J) |
启用 Javascript 的兼容性 (这里不再进一步讨论) |
(*LIMIT_MATCH=n) |
限制 n 的匹配数量 |
(*LIMIT_RECURSION=n) |
限制 n 的递归级别 |
(*NO_START_OPT) |
禁用一些优化 (这里不再进一步讨论) |
回溯控制
(*ACCEPT) |
强制当前子程序或顶层模式立即匹配成功 |
(*FAIL) or (*F) |
强制立即匹配失败 |
(*MARK:name) or (*:name) |
(请参阅参考文档.) |
(*COMMIT) |
(请参阅参考文档.) |
(*PRUNE) |
(请参阅参考文档.) |
(*PRUNE:name) |
(请参阅参考文档.) |
(*SKIP) |
(请参阅参考文档.) |
(*SKIP:name) |
(请参阅参考文档.) |
(*THEN) |
(请参阅参考文档.) |
(*THEN:name) |
(请参阅参考文档.) |
1. 当 UCP 启用, 案例检测匹配适用于完整的 Unicode 平面 0. 在 Unicode 中也有少量的多对一映射，像小写希腊字母的 sigma; 这些都支持 UCP 启用 PCRE.
2. 备用的几个转义形式存在与 Perl, Ruby, Python, JavaScript, .NET 和其他引擎的兼容性. 不要使用此处未列出的结构: 某些就干脆不工作, 有些会提供错误的结果, 有些会造成严重的问题，或只能是崩溃.
3. 默认的换行符序列约定是不会打破的 @CRLF 或或单独的 @CR 或 @LF. \R 匹配相同的一组. 确信你的数据! 如果你知道你的主题使用单独的 @LF 或 @CR 是指别的换行符, 你可能要改变换行符约定和/或匹配 \R (见 "设置").
另请参阅 正则表达式 指南, 在其中您可以运行脚本来测试您的正则表达式的取值.
函数示例
Option 1, using offset parameter
#include <MsgBoxConstants.au3>
#include <StringConstants.au3>
Local $aArray = 0, _
$iOffset = 1
While 1
$aArray = StringRegExp('<test>a</test> <test>b</test> <test>c</Test>', '(?i)<test>(.*?)</test>', $STR_REGEXPARRAYMATCH, $iOffset)
If @error Then ExitLoop
$iOffset = @extended
For $i = 0 To UBound($aArray) - 1
MsgBox($MB_SYSTEMMODAL, "RegExp Test with Option 1 - " & $i, $aArray[$i])
Next
WEnd
Option 2, single return, php/preg_match() style
#include <MsgBoxConstants.au3>
#include <StringConstants.au3>
Local $aArray = StringRegExp('<test>a</test> <test>b</test> <test>c</Test>', '(?i)<test>(.*?)</test>', $STR_REGEXPARRAYFULLMATCH)
For $i = 0 To UBound($aArray) - 1
MsgBox($MB_SYSTEMMODAL, "RegExp Test with Option 2 - " & $i, $aArray[$i])
Next
Option 3, global return, old AutoIt style
#include <MsgBoxConstants.au3>
#include <StringConstants.au3>
Local $aArray = StringRegExp('<test>a</test> <test>b</test> <test>c</Test>', '(?i)<test>(.*?)</test>', $STR_REGEXPARRAYGLOBALMATCH)
For $i = 0 To UBound($aArray) - 1
MsgBox($MB_SYSTEMMODAL, "RegExp Test with Option 3 - " & $i, $aArray[$i])
Next
Option 4, global return, php/preg_match_all() style
#include <MsgBoxConstants.au3>
#include <StringConstants.au3>
Local $aArray = StringRegExp('F1oF2oF3o', '(F.o)*?', $STR_REGEXPARRAYGLOBALFULLMATCH)
Local $aMatch = 0
For $i = 0 To UBound($aArray) - 1
$aMatch = $aArray[$i]
For $j = 0 To UBound($aMatch) - 1
MsgBox($MB_SYSTEMMODAL, "RegExp Test with Option 4 - " & $i & ',' & $j, $aMatch[$j])
Next
Next
----------------------------------------
该函数可以通过命令 exect 调用
参见:
StringRegExpReplace, StringInStr
exect=$var_s=ClipGet()||$var_n=StringRegExp('$var_s','(\d{1,4}x\d{1,4})') <IF> $var_n = 0 <THEN> exect=$var_s='100x100' <ENDIF> exect=_ViewValues('$var_s') ;; 如果剪贴板的内容不是0x0或00x00或000x000或0000x0000形式的字符串(其中可以是任何数字而不是零)，则变量$var_s = 100x100
exect=$var_s0=ClipGet()||$var_s1=StringRegExp('$var_s0','(\d{1,4}x\d{1,4})')=0?'100x100':'$var_s0'||_ViewValues('$var_s1') ;; 如果剪贴板的内容不是0x0或00x00或000x000或0000x0000形式的字符串(其中可以是任何数字而不是零)，则变量$var_s = 100x100
exect=$var_s1=StringRegExp(ClipGet(),'(\d{1,4}x\d{1,4})')=0?'100x100':ClipGet()||_ViewValues('$var_s1') ;; 如果剪贴板的内容不是0x0或00x00或000x000或0000x0000形式的字符串(其中可以是任何数字而不是零)，则变量$var_s = 100x100
exect=$var_s=##[input=BOX73]||$var_ar=StringRegExp(FileRead(@CRLF&'C:\dictionary.txt'&@CRLF),'[\r\n](['&'$var_s'&']+)[\r\n]',3)||_ViewValues($var_ar)||$var_s=_ArrayToString($var_ar,@CRLF) bufsr=##$var_s ;;发送到剪贴板的所有单词组成的字母输入在对话框中，这是字典dictionary.txt的一部分(该列表包含单词，排列所有给定的集合字母重复的字母没有确切的长度)
exect=$var_s=##[input=BOX73]||$var_ar=StringRegExp(@CRLF&FileRead('C:\dictionary.txt')&@CRLF,'[\r\n](['&'$var_s'&']{3,6})[\r\n]',3)||_ViewValues($var_ar)||$var_s=_ArrayToString($var_ar,@CRLF) bufsr=##$var_s ;; 发送到剪贴板的所有单词形成从字母dictionary.txt的一部分在对话框中输入的字母(该列表包括字母，排列所有字母的重复的字母和长度为5个字符)
exect=$var_s=##[input=BOX73]||$var_ar=StringRegExp(@CRLF&FileRead('C:\dictionary.txt')&@CRLF,'[\r\n](['&'$var_s'&']{5})[\r\n]',3)||_ViewValues($var_ar)||$var_s=_ArrayToString($var_ar,@CRLF) bufsr=##$var_s ;; 发送到剪贴板的所有单词组成的字母在字典dictionary.txt的对话框中输入的字母(该列表包括字，排列所有的字母，重复的字母和长度从3到6个字符)
exect=$var_s=##[input=BOX73]||$var_ar=StringRegExp(@CRLF&FileRead('C:\dictionary.txt')&@CRLF,'[\r\n](['&'$var_s'&']{[input=BOX74],[input=BOX75]})[\r\n]',3)||_ViewValues($var_ar)||$var_s=_ArrayToString($var_ar,@CRLF) bufsr=##$var_s ;; 发送到剪贴板的所有单词组成的字母在对话框中输入的字典dictionary.txt的一部分(该列表包括单词，排列所有字母的重复的字母和长度在对话框中设置)
exect=$var_ac=StringRegExp(ClipGet()&@CR&@CR,'(?m)^([^\r\n]*)',3)||$var_ab=StringSplit('TOTALCMD#BAR#DATA|%%COMMANDER_PATH%%\TCIMG.exe|#|Wcmicons.dll,0|','|',2)||$var_ab[2]=$var_ac[0]||$var_ab[4]=$var_ac[1]||_ArrayToClip($var_ab,@CRLF) ;; 从剪贴板(命令和描述)中的2行创建一个TCMG按钮为Total Commander并写入剪贴板
exect=_ViewValues(StringRegExp(ClipGet(),'(?m)^([^\r\n]*)',3)) ;; 将剪贴板的内容分成数组行和查看数组a
exect=_ViewValues(StringRegExp(FileRead('%P%N'),'(?m)^([^\r\n]*)',3),'%P%N') ;; 在数组行和视图数组中将文件的内容拆分为光标
sends=-1 exect=$var_a='GLOBALSENDS<1>' GLOBALEXECT<a> exect=$var_name=StringRegExp('GLOBALEXECT<1>','^[~~-_]?$',0)?'>':'test'||_ViewValues('$var_name') ;; 检查剪贴板的例子：如果在缓冲区空格， - ，_或空，那么$var_name是用符号>，否则测试
exect=$var_a=StringRegExp(FileRead('%P%N'),'(?ms)@font-face(?:[\s]+)?\{[^\{]+\}',3)||_ViewValues($var_a) ;; 在游标下分割成数组文件css所有的片段@ font-face
exect=$var_a=StringRegExp(FileRead('%P%N'),'(?ms)@font-face(?:[\s]+)?\{[^\{]+\}',3)||_ViewValues($var_a)||$var_a=_ArrayUnique($var_a)||_ViewValues($var_a) ;; 在游标下分割成数组css文件所有的片段@ font-face和删除重复的片段
sends=\<link\h+rel\=[\''|\']?[^>]+\>??1 exect=$var_a=_ArrayUnique(StringRegExp(FileRead('%P%N'),$GLOBALSENDS[1],3))||_ViewValues($var_a) ;; 在光标下获取指定的文件段，并在表中显示它们
exect=$var_s=ClipGet()||$var_i=StringRegExp(ClipGet(),'([^A-Za-z\d])',0)?MsgBox(48+4096,'Результат','Число~~в~~буфере~~не~~является~~хэшем.')&_Exit():1||$var_i=StringLen('$var_s')||$var_n=$var_i=8?3:($var_i=32?1:($var_i=64?6:($var_i=128?8:MsgBox(48+4096,'Результат','Число~~в~~буфере~~не подходит~~под~~условие~~проверки.')&_Exit())))||$var_path=$var_n&'%P%N' <IF> <info=f$var_path|1//> = $var_s <THEN> exect=MsgBox(64+4096,'Результат','Контрольные~~суммы~~совпадают.') <ELSE> exect=MsgBox(48+4096,'Результат','Контрольные~~суммы~~не~~совпадают.') <ENDIF> ;; 取决于缓冲线长度校验文件进行比较光标和剪贴板下：如果如图8所示，比较发生CRC32，如果32 - MD5，如果64 - SHA256，如果128 - SHA512，具有手动关闭一个弹出窗口，报告结果
exect=$var_s=StringRegExp(ClipGet(),'(?i)^[a-z]',0)?'1,2':'2,1' sends=-1!!-1||#L$var_s GLOBALSENDS<a> ;; 如果在剪贴板上的第一个字母的西里尔字母表，然后改变第一和第二行
exect=$var_a=StringRegExp(FileRead('%P%N'),'(?m)((?:[^\r\n]+(?:\r\n|$)+){5})',3)||_ViewValues($var_a) ;; 将光标下的文本文件拆分5行
slist=%L exect=$var_a=StringRegExp(FileRead('GLOBALSLIST<t>'),'(?m)((?:[^\r\n]+(?:\r\n|$)+){5})',3) GLOBALEXECT<a> ;; 将所选对象的路径分为5组
slist=%L exect=$var_a=StringRegExp(FileRead('GLOBALSLIST<t>'),'(?m)((?:[^\r\n]+(?:\r\n|$)+){1,5})',3) GLOBALEXECT<a> ;; 将所选对象的路径分成5 +的余数(如果分配不是5的倍数)
© Аверин Андрей для Total Commander Image Averin-And@yandex.ru