【转】CAtlRegExp class .

CAtlRegExp Class

CAtlRegExp 类用于表示并处理正则表达式。模板类,定义如下:

template <
class CharTraits = CAtlRECharTraits
>
class CAtlRegExp

参数



CharTraits


字符特征对象.例如, 默认的 CAtlRECharTraitsA.

摘要


调用 Parse 方法设置正则表达式

CAtlRegExp<> re;
re.Parse( "{[0-9]?[0-9]}:{[0-9][0-9]}" ); // Time in h:mm or hh:mm format

Parse 将正则表达式转换为 CAtlRegExp
内部的模式匹配自动机.

调用 Match 方法实现对字符串的匹配

re.Match( "1:57", &mc );  // Returns TRUE: successful match
re.Match( "01/03", &mc ); // Returns FALSE: no match

Match 方法的参数是需要匹配的字符串以及一个 CAtlREMatchContext 对象。如上所述的正则表达式,有两组对比通过大括号分隔,如果正则表达式和输入字符串匹配,CAtlREMatchContext 对象可以用来从输入字符串中提取实际匹配组的字符串(在该例中,是小时和分钟)。详细信息可参考 CAtlReMatchContext.

Match 方法有第三个可选的参数。如果使用第三个可选的参数, Match 会设置其指向字符串中匹配的最后一个字符的下一个位置。这使得你可以继续比对剩余的字符串。

正则表达式语法:

CAtlRegExp 下使用的正则表达式语法
















































元字符 含义

.

匹配任意的单个字符.

[ ]

表示一个字符类.匹配方括号下的任意一个字符。 (例如, [abc] 匹配 "a",
"b", 和 "c").

^

如果该元字符在一个字符类的开始处使用,它表示对字符类取反。一个取反的字符类匹配除该字符类里的任意字符。
(例如, [^abc] 匹配除了 "a", "b", 和 "c"以外的字符).

如果 ^ 处在正则表达式的开始处,
它将匹配输入的开始字符串部分。(例如, ^[abc] 只匹配以"a", "b", 或
"c"开始的字符串).

-

在字符类内部,表示字符的方位。 (例如, [0-9] 匹配从"0" 到
"9"的任意数字).

?

表示在前面的表达式是可选的: 它将匹配1次或0次
(例如, [0-9][0-9]? 匹配"2" 和 "12").

+

表示前面的表达式匹配一到多次。 (例如, [0-9]+   匹配 "1",
"13", "456",等).

*

表示前面的表达式匹配0 到 多次.

??, +?, *?

? , + 和 * 的非穷尽(Non-greedy)版。和? , + , * 
不同,非穷尽版进行尽可能少的匹配。

(例如, 假设有输入
 "<abc><def>",   <.*?>   
匹配 "<abc>"      但是
 <.*>   匹配 "<abc><def>").

( )

组操作. 例如: (\d+,)*\d+  匹配一组被逗号分隔的数字(例如, "1" or
"1,23,456").

{ }

表示一个匹配组. 对于输入字符串,匹配大括号里的正则表达式的实际文本可以通过 CAtlREMatchContext 对象检索.

\

转义字符: 对下一个字符进行字面翻译。(例如, [0-9]+ 匹配一个活多个数字, 
但是[0-9]\+匹配一个数字后加一个"+"字符).

也可用于缩写(例如 \a 表示任意字母数字; 参见下表).

如果 \ 后面紧跟一个数字 n,它将匹配第n个匹配组(从0开始).
例如: <{.*?}>.*?</\0>   匹配
"<head>Contents</head>".

注意,
在C++的字符串中, 必须使用双斜杠: "\\+""\\a""<{.*?}>.*?</\\0>".

$

在正则表达式的尾部,该字符匹配输入字符串的尾部。 (例如,[0-9]$ 匹配以数字结尾的输入).

|

交替操作符: 分隔两个表达式, 表示两个匹配其中一个 (例如, T|the 匹配 "The"
or "the").

!

取反操作符: the expression following ! does not match the
input(for example, a!b matches "a" not followed by
"b").

缩写词

CAtlRegExp 可以处理缩写词, 例如使用 \d 替换[0-9].
缩写词由传递给CharTraits 的参数提供.
预定义的字符特性提供如下所示的缩写。
































Abbreviation Matches

\a

任意字母数字: ([a-zA-Z0-9])

\b

空格 (空): ([ \\t])

\c

任意字母: ([a-zA-Z])

\d

任意十进制数字: ([0-9])

\h

任意十六进制数字: ([0-9a-fA-F])

\n

换行: (\r|(\r?\n))

\q

带引号的字符串: (\"[^\"]*\")|(\‘[^\‘]*\‘)

\w

一个简单的单词: ([a-zA-Z]+)

\z

一个整数: ([0-9]+)

Example


下述例子使用正则表达式提取URL部分

// catlregexp_class.cpp
#include <afx.h>
#include <atlrx.h>

int main(int argc, char* argv[])
{
CAtlRegExp<> reUrl;
// Five match groups: scheme, authority, path, query, fragment
REParseError status = reUrl.Parse(
"({[^:/?#]+}:)?(//{[^/?#]*})?{[^?#]*}(?{[^#]*})?(#{.*})?" );

if (REPARSE_ERROR_OK != status)
{
// Unexpected error.
return 0;
}

CAtlREMatchContext<> mcUrl;
if (!reUrl.Match(
"http://search.microsoft.com/us/Search.asp?qu=atl&boolean=ALL#results",
&mcUrl))
{
// Unexpected error.
return 0;
}

for (UINT nGroupIndex = 0; nGroupIndex < mcUrl.m_uNumGroups;
++nGroupIndex)
{
const CAtlREMatchContext<>::RECHAR* szStart = 0;
const CAtlREMatchContext<>::RECHAR* szEnd = 0;
mcUrl.GetMatch(nGroupIndex, &szStart, &szEnd);

ptrdiff_t nLength = szEnd - szStart;
printf_s("%d: \"%.*s\"\n", nGroupIndex, nLength, szStart);
}

return 0;
}

Output

0: "http"
1: "search.microsoft.com"
2: "/us/Search.asp"
3: "qu=atl&boolean=ALL"
4: "results"

Requirements












需要头文件 兼容性

CAtlRegExp

<atlrx.h>

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium
Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP
Professional, Windows Server 2003, Windows Server 2003

参考:

http://msdn.microsoft.com/zh-cn/library/k3zs4axe(v=vs.80).aspx

注: 英文很烂,翻译不好,如有错误,欢迎提醒!

时间: 2025-01-03 01:19:38

【转】CAtlRegExp class .的相关文章

ATL正则表达式库与CAtlRegExp的使用

正则表达式是最强大的文本解析工具之一, 在ATL中也提供了一些用于正则表达式的类库(CATLRegExp等),本文将简要说明这些类库的使用方法. 1.CATLRegExp类 声明: template <class CharTraits=CAtlRECharTraits> class CAtlRegExp; 初始化: 与微软的GRETA类库(微软研究院推出的另一个正则表达式类库)不同,CATLRegExp并没有在构造函数中提供初始化匹配字符串的方法,而是让使用者通过调用它的Parse()方法,使

[转]Microsoft Platform SDK 选择及在vc++6.0中的配置

Windows Platform SDK Download Sites: Windows Server 2003 PSDK February 2003 Edition,可以和VC6一起使用.并支持各种目标OS的最后一个版本的SDK. This edition of the SDK supports development for the following platforms: Windows Server 2003 Windows Advanced Server, Limited Editio

邮件服务器编程

刚开始做邮件服务器开发,一切都是茫然的.在书上网上都很难找到一套完整的邮件服务器开发教程.在个人的摸索中碰到了很多蛋疼得问题.现终于完成了,将我的开发经验分享给大家. 开发环境:vs2012 mfc 注意事项: 1. 网络环境: 作为邮件服务器,要接收来自互联网的邮件,就得有能映射到外网的服务器.至少映射25(SMTP)端口(pop3都暂时不重要).对于没有外网条件的的小伙伴,推荐以下几种方法调试: A.如果你使用model上网,查看你的电脑的外网IP.看看是否和model的一致.一致则说明你有