string.regex 库模块帮助文档

正则表达式语法请参考：preg 扩展库使用指南

string 成员列表 #

string.regex("字符串参数") #

创建正则表达式，注意正则表达式首尾不需要添加斜杆。

string.regex() #

返回对象:stringRegexObject

string.regex 成员列表 #

正则表达式支持库，基于操作系统自带的 VBScript.RegExp 组件。
建议改用 preg 扩展库（更快更强大）或 aardio 自带的模式匹配（更简单更快）。

正则表达式语法请参考 preg 扩展库使用指南。

string.regex.find(str,pattern) #

从字符串参数 @str 开头查找 @pattern 参数指定的正则表达式。
匹配失败返回 null，匹配成功返回字符串开始位置与结束位置，按字符个数计数（不是按字节计数）。
正则表达式语法错误会抛出异常。

string.regex.gmatch(str,pattern) #

从字符串参数 @str 开头尝试全局匹配 @pattern 参数指定的正则表达式。
返回适用于 for in 语句的迭代器。

如果指定了捕获组，每次迭代遍历时都返回一个或多个捕获组对应的字符串。
如果未指定捕获组，每次迭代遍历时都返回包含完整匹配结果的单个字符串。
正则表达式语法错误会抛出异常。

string.regex.match(str,pattern) #

从字符串 str 开头尝试匹配 pattern 参数指定的正则表达式。
匹配失败返回 null，匹配成功返回字符串数组。
如果指定了捕获组，则返回数组对应所有捕获组匹配的字符串。
如果未指定捕获组，则返回包含单个字符串的（匹配结果）数组。
正则表达式语法错误会抛出异常。

string.regex.replace(str,pattern,repl) #

从字符串参数 @str 开头全局替换 @pattern 参数指定正则表达式匹配的字符串。
@repl 参数指定替换字符串，替换参数不能是函数。
返回替换后的新字符串。
正则表达式语法错误会抛出异常。

string.regex.test(str,pattern) #

从字符串参数 @str 开头查找 @pattern 参数指定的正则表达式。
匹配失败返回 false，匹配成功返回 true。
正则表达式语法错误会抛出异常。

stringRegexMatchObject 成员列表 #

stringRegexMatchObject.FirstIndex #

位置

stringRegexMatchObject.Length #

长度

stringRegexMatchObject.SubMatches(索引) #

匹配子串（用括号指定的分捕获分组），
对于外部 COM 对象第一个元素索引为 0（aardio 数组起始索引则为 1）。

stringRegexMatchObject.Value #

匹配结果

stringRegexObject 成员列表 #

stringRegexObject.Global #

是否全局匹配。
只能设为 false 或 true 。
默认为 true 表示启用全局匹配。
注意调用 gmatch,match,replace 等函数会自动修改此属性。

stringRegexObject.IgnoreCase #

是否忽略大小写

stringRegexObject.Pattern #

设置或返回用于匹配的正则表达式。

stringRegexObject.find(目标字符串,".+") #

从字符串参数 @1 开头查找 @2 参数指定的正则表达式。
如果不指定参数 @2 则使用创建 string.regex 时指定的默认正则表达式。
匹配失败返回 null，匹配成功返回字符串开始位置与结束位置，按字符个数计数（不是按字节计数）。
正则表达式语法错误会抛出异常。

stringRegexObject.gmatch(str,pattern) #

for m1,m2 in regex.gmatch(/*要匹配的字符串*/,".+"){
    /*从字符串参数 @1 开头全局匹配 @2 参数指定的正则表达式。  
如果不指定参数 @2 则使用创建 string.regex 时指定的默认正则表达式。  
如果指定了捕获组，每次迭代遍历时都返回一个或多个捕获组对应的字符串。  
如果未指定捕获组，每次迭代遍历时都返回包含完整匹配结果的单个字符串。  
正则表达式语法错误会抛出异常。*/
}

stringRegexObject.replace(str,pattern,repl) #

从字符串参数 @str 开头全局替换 @pattern 参数指定正则表达式匹配的字符串。
如果 @pattern 为 null 则使用创建 string.regex 时指定的默认正则表达式。
@repl 参数指定替换字符串，替换参数不能是函数。
返回替换后的新字符串。
正则表达式语法错误会抛出异常。

Markdown 格式