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", |
^ |
如果该元字符在一个字符类的开始处使用,它表示对字符类取反。一个取反的字符类匹配除该字符类里的任意字符。 如果 ^ 处在正则表达式的开始处, |
- |
在字符类内部,表示字符的方位。 (例如, [0-9] 匹配从"0" 到 |
? |
表示在前面的表达式是可选的: 它将匹配1次或0次 |
+ |
表示前面的表达式匹配一到多次。 (例如, [0-9]+ 匹配 "1", |
* |
表示前面的表达式匹配0 到 多次. |
??, +?, *? |
? , + 和 * 的非穷尽(Non-greedy)版。和? , + , * (例如, 假设有输入 |
( ) |
组操作. 例如: (\d+,)*\d+ 匹配一组被逗号分隔的数字(例如, "1" or |
{ } |
表示一个匹配组. 对于输入字符串,匹配大括号里的正则表达式的实际文本可以通过 CAtlREMatchContext 对象检索. |
\ |
转义字符: 对下一个字符进行字面翻译。(例如, [0-9]+ 匹配一个活多个数字, 也可用于缩写(例如 \a 表示任意字母数字; 参见下表). 如果 \ 后面紧跟一个数字 n,它将匹配第n个匹配组(从0开始). 注意, |
$ |
在正则表达式的尾部,该字符匹配输入字符串的尾部。 (例如,[0-9]$ 匹配以数字结尾的输入). |
| |
交替操作符: 分隔两个表达式, 表示两个匹配其中一个 (例如, T|the 匹配 "The" |
! |
取反操作符: the expression following ! does not match the |
缩写词
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]+) |
下述例子使用正则表达式提取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"
类 | 需要头文件 | 兼容性 |
---|---|---|
CAtlRegExp |
<atlrx.h> |
Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium |
参考:
http://msdn.microsoft.com/zh-cn/library/k3zs4axe(v=vs.80).aspx
注: 英文很烂,翻译不好,如有错误,欢迎提醒!