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]+) |
// 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"
| 类 | 需要头文件 | 兼容性 |
|---|---|---|
|
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 |