支持库名称及版本:正则表达式支持库 (2.0#0版) 所支持语言:中文(大陆) 该支持库实现了对正则表达式(Regular Expression)的支持。注意,本支持库中的所有命令均为高级命令,要求使用者具有一定的正则表达式知识基础。 本库为一般支持库,需要易系统3.8版本的支持,需要系统核心支持库3.7版本的支持,提供了2种库定义数据类型,提供了17种命令。 操作系统需求: Windows、Linux、Unix 支持库文件名: D:\易语言\5.95\lib\RegEx.fne ----- 支持库的作者信息 ----- 作者姓名:大有吴涛易语言软件公司 邮政编码:116001 通信地址:辽宁省大连市中山区人民路55号亚太国际金融中心 电话号码:+86(0411)39895831 QQ号码:+86(0411)39895834 电子信箱:service@dywt.com.cn 主页地址:http://www.eyuyan.com 其它信息:祝您一帆风顺,心想事成! --- 库定义数据类型列表 --- 数据类型名称:正则表达式 英文名称:regex 本数据类型为普通类型,共包含 11 个成员命令, 1 个成员变量。 操作系统需求: Windows、Linux、Unix 一个正则表达式(regular expression)描述了一种文本匹配的模式,可以被用来检查一段文本是否符合某种特定的格式(匹配模式)或在一段文本中寻找、提取特定格式的子文本等。比如校验一段文本是否为有效的URL地址、从文本文件中提取所包含的E-Mail地址(请参考本支持库附带的例程)。关于正则表达式的更多知识,请查阅相关的书籍、资料。 成员<2>的中文名称为“多行模式”,英文名称为“MultiLine”,类型为“逻辑型(bool)”,初始值为“真”。 指定在搜索、替换时,是否使用多行模式。 如果本成员值为真,字符“^”不仅匹配目标文本的开头,而且匹配目标文本中换行符(字符(10),字符(13)或 #换行符)的后面;字符“$”不仅匹配目标文本的结尾,而且匹配目标文本中换行符的前面。否则字符“^”仅仅匹配目标文本的开头,“$”也仅仅匹配目标文本的结尾。 组件事件列表: 调用格式: 〈逻辑型〉 对象.创建 (文本型 正则表达式文本,[逻辑型 是否区分大小写]) - 正则表达式支持库->正则表达式 英文名称:Create 根据指定的正则表达式文本创建一个正则表达式对象。本对象中的原有内容将被释放。成功返回真;否则返回假。本命令为高级对象成员命令。 参数<1>的名称为“正则表达式文本”,类型为“文本型(text)”。比如“易语言4\.0(模块|支持库)?”。 参数<2>的名称为“是否区分大小写”,类型为“逻辑型(bool)”,可以被省略。本参数指定这个正则表达式在创建成功后进行匹配、搜索、替换时,是否区分大小写。如果本参数被省略,默认值为“真”。 操作系统需求: Windows、Linux、Unix 调用格式: 〈逻辑型〉 对象.是否为空 () - 正则表达式支持库->正则表达式 英文名称:IsEmpty 如果本对象的内容为空或尚未创建,返回真;否则返回假。本命令为高级对象成员命令。 操作系统需求: Windows、Linux、Unix 调用格式: 〈文本型〉 对象.取文本 () - 正则表达式支持库->正则表达式 英文名称:GetText 返回以文本形式表示的正则表达式。如果该对象尚未创建,则返回空文本。本命令为高级对象成员命令。 操作系统需求: Windows、Linux、Unix 调用格式: 〈整数型〉 对象.取子表达式个数 () - 正则表达式支持库->正则表达式 英文名称:GetSubExpCount 返回该表达式中子表达式(用圆括号标记)的个数。比如“易语言4\.0(模块|支持库)?”中包含1个子表达式:“(模块|支持库)”。本命令为高级对象成员命令。 操作系统需求: Windows、Linux、Unix 调用格式: 〈逻辑型〉 对象.匹配 (文本型 用来匹配的文本) - 正则表达式支持库->正则表达式 英文名称:Match 用一个正则表达式来匹配一个文本。如果这个文本符合正则表达式指定的模式,返回真;否则返回假。比如: 正则表达式.创建 (“易语言4\.0(模块|支持库)?”) 信息框 (正则表达式.匹配 (“易语言4.0支持库”), 0, ) 将显示“真”。本命令为高级对象成员命令。 参数<1>的名称为“用来匹配的文本”,类型为“文本型(text)”。 操作系统需求: Windows、Linux、Unix 调用格式: 〈搜索结果〉 对象.搜索 (文本型 欲被搜索的文本,整数型 起始搜索位置,[整数型 搜索长度]) - 正则表达式支持库->正则表达式 英文名称:Search 使用指定的正则表达式搜索指定文本中与该表达式匹配的子文本。注意,出于搜索效率考虑,被搜索的文本没有存放在返回的“搜索结果”中,所以在调用“搜索结果.取匹配文本”和“搜索结果.取子匹配文本”时,请注意给“被搜索的文本”传递的参数应该和对应的本命令的“欲被搜索的文本”参数相同。本命令为高级对象成员命令。 参数<1>的名称为“欲被搜索的文本”,类型为“文本型(text)”。 参数<2>的名称为“起始搜索位置”,类型为“整数型(int)”,初始值为“1”。 参数<3>的名称为“搜索长度”,类型为“整数型(int)”,可以被省略。本参数和“起始搜索位置”一起指定搜索的范围。如果本参数被省略,默认值为从“起始搜索位置”到文本结尾的长度。 操作系统需求: Windows、Linux、Unix 调用格式: 〈文本型〉 对象.替换 (文本型 欲被替换的文本,文本型 替换格式,整数型 起始替换位置,[整数型 替换长度],逻辑型 是否包含不匹配部分,逻辑型 是否全部替换) - 正则表达式支持库->正则表达式 英文名称:Replace 使用指定的正则表达式搜索指定文本中与该表达式匹配的子文本,并按照指定的格式进行替换。返回替换后的文本。本命令为高级对象成员命令。 参数<1>的名称为“欲被替换的文本”,类型为“文本型(text)”。 参数<2>的名称为“替换格式”,类型为“文本型(text)”。本参数指定替换的具体方式。比如“$1”表示把第一个子表达式所匹配的文本显示为灰色(在HTML中)。 参数<3>的名称为“起始替换位置”,类型为“整数型(int)”,初始值为“1”。 参数<4>的名称为“替换长度”,类型为“整数型(int)”,可以被省略。本参数和“起始替换位置”一起指定替换的范围。如果本参数被省略,默认值为从“起始替换位置”到文本结尾的长度。 参数<5>的名称为“是否包含不匹配部分”,类型为“逻辑型(bool)”,初始值为“真”。本参数指定替换结果中是否包含与正则表达式不匹配的部分。如果本参数为假,则不匹配部分将被抛弃。 参数<6>的名称为“是否全部替换”,类型为“逻辑型(bool)”,初始值为“真”。如果本参数为真,则参数1中所有匹配的子文本均被替换,否则仅第一个匹配的子文本被替换。 操作系统需求: Windows、Linux、Unix 调用格式: 〈搜索结果数组〉 对象.搜索全部 (文本型 欲被搜索的文本) - 正则表达式支持库->正则表达式 英文名称:SearchAll 使用指定的正则表达式搜索指定文本中与该表达式匹配的所有子文本。返回值包含所有的搜索结果的一维数组,数组原有内容将被销毁,维数也将根据需要做相应调整。本命令的内部是通过循环多次调用“搜索”,每次指定适当的参数,来实现搜索整个文本的。返回值数组的各个成员分别对应每次调用“搜索”的返回值。本命令可高效地一次性取得目标文本中所有的匹配子文本信息。本命令为高级对象成员命令。 参数<1>的名称为“欲被搜索的文本”,类型为“文本型(text)”。 操作系统需求: Windows、Linux、Unix 成员“多行模式”所在数据类型为“正则表达式”,英文名称为“MultiLine”,类型为“逻辑型(bool)”,初始值为“真”。 指定在搜索、替换时,是否使用多行模式。 如果本成员值为真,字符“^”不仅匹配目标文本的开头,而且匹配目标文本中换行符(字符(10),字符(13)或 #换行符)的后面;字符“$”不仅匹配目标文本的结尾,而且匹配目标文本中换行符的前面。否则字符“^”仅仅匹配目标文本的开头,“$”也仅仅匹配目标文本的结尾。 --------------------------------------------------- 数据类型名称:搜索结果 英文名称:SearchResult 本数据类型为普通类型,共包含 6 个成员命令。 操作系统需求: Windows、Linux、Unix 该类型的变量一般用来接收和分析“正则表达式.搜索()”的返回值。 组件事件列表: 调用格式: 〈逻辑型〉 对象.是否为空 () - 正则表达式支持库->搜索结果 英文名称:IsEmpty 如果本对象的内容为空,返回真;否则返回假。本命令为高级对象成员命令。 操作系统需求: Windows、Linux、Unix 调用格式: 〈文本型〉 对象.取匹配文本 (文本型 被搜索的文本,[整数型变量 起始位置]) - 正则表达式支持库->搜索结果 英文名称:GetMatchText 取得与整个正则表达式匹配的子文本。本命令为高级对象成员命令。 参数<1>的名称为“被搜索的文本”,类型为“文本型(text)”。应该使用和所属的“正则表达式.搜索”命令同样的参数。 参数<2>的名称为“起始位置”,类型为“整数型(int)”,可以被省略,提供参数数据时只能提供变量。该命令调用成功后,本参数存放取得的子文本在整个被搜索文本中的起始位置。 操作系统需求: Windows、Linux、Unix 调用格式: 〈文本型〉 对象.取子匹配文本 (文本型 被搜索的文本,整数型 子表达式索引,[整数型变量 起始位置]) - 正则表达式支持库->搜索结果 英文名称:GetSubMatchText 取得与正则表达式中某个子表达式匹配的子文本。本命令为高级对象成员命令。 参数<1>的名称为“被搜索的文本”,类型为“文本型(text)”。应该使用和所属的“正则表达式.搜索”命令同样的参数。 参数<2>的名称为“子表达式索引”,类型为“整数型(int)”。欲取其值的子表达式。该参数对应与正则表达式中的一个子表达式(以圆括号标记)。索引从1开始。 参数<3>的名称为“起始位置”,类型为“整数型(int)”,可以被省略,提供参数数据时只能提供变量。该命令调用成功后,本参数存放取得的子文本在整个被搜索文本中的起始位置。 操作系统需求: Windows、Linux、Unix