分类: C/C++
2008-08-07 18:57:29
1、 CATLRegExp类
声明:
templateclass CAtlRegExp;
初始化:
与微软的GRETA类库(微软研究院推出的另一个正则表达式类库)不同,CATLRegExp并没 有在构造函数中提供初始化匹配字符串的方法,而是让使用者通过调用它的Parse()方法, 使用正则表达式字符串作为参数,就可以构造出一个我们所需要的用于匹配的类,例如我们 需要匹配一种时间格式,可以是h:mm、也可以是hh:mm,那么我们可以这样构造我们的CAtlRegExp类:CAtlRegExp <> re; re.Parse( "{[0-9]?[0-9]}:{[0-9][0-9]}" );ATL的正则表达式语法和Perl的正则表达式语法大同小异,不过有一个值得注意的地方就 是ATL中用大括号({ })表示其匹配字符串中的Group,我们上面的表达式中,就声明了2 个Group,一个是[0-9]?[0-9],另一个是[0-9][0-9]。
BOOL Match(const RECHAR *szIn, CAtlREMatchContext参数的含义很明显,不过需要注意到第一个参数的型别是:const RECHAR * szIN,是一个 const指针,这表明我们可以方便得使用std::string类的c_str()方法给其传递参数。*pContext, const RECHAR **ppszEnd=NULL)
声明:
template使用:class CAtlREMatchContext
CAtlREMatchContext通过m_uNumGroups成员以及GetMatch()方法向调用者提供匹配的结果信息。m_uNumGroups代表匹配上的Group有多少组,GetMatch()则根据传递给它的Group
的Index值,返回匹配上的字符串的pStart和pEnd指针,调用者有了这两个指针,自然可以很方便的得到匹配结果。
下面这个例子来源于MSDN,演示了CATLRegExp和CAtlREMatchContext类的典型使用方法:
#include "stdafx.h" #includeOutputint 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( "", &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("%d: \"%.*s\"\n", nGroupIndex, nLength, szStart); } }
0: "http"
1: "search.microsoft.com"
2: "/us/Search.asp"
3: "qu=atl&boolean=ALL"
4: "results"
例子中所用的正则表达式为:
({[^:/?#] }:)?(//{[^/?#]*})?{[^?#]*}(?{[^#]*})?(#{.*})?
以()为分界标志,共分成5组,第一组是{[^:/?#] }:,^是“非”后面成员的意思,那么也就是说第一组从开头开始,一直到:、/、?、#其中任何一个结束。联系后面的待匹配字符串就可以得出所匹配的结果是http。
4、 自定义匹配字符串的缩写形式
为了方便,ATL已经帮我们定义了一些经常用到的正则表达式的简略形式。例如:\d代表([0-9])、\n代表(\r|(\r?\n))等。这些缩写形式都体现在CAtlRECharTraitsA/CAtlRECharTraitsW等类中,把这些类作为模板参数传递给CATLRegExp和 CAtlREMatchContext,我们就可以定义自己的匹配字符串缩写了。
class CAtlRECharTraitsA { static const RECHARTYPE** GetAbbrevs() { static const RECHARTYPE *s_szAbbrevs[] = { "a([a-zA-Z0-9])", // alpha numeric "b([ \\t])", // white space (blank) "c([a-zA-Z])", // alpha "d([0-9])", // digit "h([0-9a-fA-F])", // hex digit "n(\r|(\r?\n))", // newline "q(\"[^\"]*\")|(\''''[^\'''']*\'''')", // quoted string "w([a-zA-Z] )", // simple word "z([0-9] )", // integer NULL }; return s_szAbbrevs; } };以上是atlrx.h摘录下来的代码,可以很清楚地看到ATL是通过一个GetAbbrevs()函数 来定义字符串缩写的。要定义新的缩写形式,我们只需要这样:
class MyRegTraits : public ATL::CAtlRECharTraitsA { public: static const RECHARTYPE** GetAbbrevs() { static const RECHARTYPE *s_szAbbrevs[] = { "a([a-zA-Z0-9])", // alpha numeric "b([ \\t])", // white space (blank) "c([a-zA-Z])", // alpha "d([0-9])", // digit "h([0-9a-fA-F])", // hex digit "n(\r|(\r?\n))", // newline "q(\"[^\"]*\")|(\''''[^\'''']*\'''')", // quoted string "w([a-zA-Z] )", // simple word "z([0-9] )", // integer "e([0-8] )", //自己添加 NULL }; return s_szAbbrevs; } };让我们自己定义的Trait类继承自CAtlRECharTraitsA,然后改写GetAbbrevs()函数,增加 一些需要的简写就可以被使用了。下面的代码示例了使用了我们自己的类中定义的“\e”简 略表达:
int main ( ) { ATL::CAtlRegExp < MyRegTraits > re ; re.Parse( "\\e " ); ATL::CAtlREMatchContext < MyRegTraits > mc ; BOOL res1 = re.Match( "678", &mc ); // returns TRUE: successful match res1 = re.Match ( "999" , &mc ) ; // returns FALSE:match fail }只要在构造ATL::CAtlRegExp和 ATL::CAtlREMatchContext类时,传递过去我们的 MyRegTraits类作为Traits的参数,就可以直接使用自己定义的简略符号了。