ATL正则表达式库使用

ATL中，因为ATL Server的须要，须要对Client发送过来的地址、命令等复杂文字字段信息解码，而正则表达式是公认的最强大的文字解析工具，因此，ATL提供了一些用于正则表达式的库方便了咱们的工做。

一、 CATLRegExp类

声明：

template <class CharTraits=CAtlRECharTraits>
class 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]。

匹配： 
调用CATLRegExp的Match()方法，就能够用该类来进行匹配了，Match方法的原型以下：

BOOL Match(const RECHAR *szIn, CAtlREMatchContext<CharTraits> *pContext, const RECHAR **ppszEnd=NULL)

参数的含义很明显，不过须要注意到第一个参数的型别是：const RECHAR * szIN，是一个 const指针，这代表咱们能够方便得使用std::string类的c_str()方法给其传递参数。 

Match的结果经过第二个参数pContext所指向的CAtlREMatchContext<>类来返回，Match 的结果及其相关信息都被存放在CAtlREMatchContext类中，咱们只要访问CAtlREMatchContext的方法和成员就能够获得匹配的结果。 

二、 CAtlREMatchContext类

声明：

template <class CharTraits=CAtlRECharTraits>
class CAtlREMatchContext

使用：

CAtlREMatchContext经过m_uNumGroups成员以及GetMatch（）方法向调用者提供匹配的结果信息。m_uNumGroups表明匹配上的Group有多少组，GetMatch()则根据传递给它的Group
的Index值，返回匹配上的字符串的pStart和pEnd指针，调用者有了这两个指针，天然能够很方便的获得匹配结果。

三、 一个小示例

下面这个例子来源于MSDN，演示了CATLRegExp和CAtlREMatchContext类的典型使用方法：

#include "stdafx.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("%d: \"%.*s\"\n", nGroupIndex, nLength, szStart);
   }
}

Output

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

例子中所用的正则表达式为：

({[^:/?#]+}:)?(//{[^/?#]*})?{[^?#]*}(?{[^#]*})?(#{.*})?

以（）为分界标志，共分红5组，第一组是{[^:/?#]+}:，^是“非”后面成员的意思，那么也就是说第一组从开头开始，一直到:、/、?、#其中任何一个结束。联系后面的待匹配字符串就能够得出所匹配的结果是http。

四、 自定义匹配字符串的缩写形式

为了方便，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的参数，就能够直接使用本身定义的简略符号了。

五、 结尾

虽然如今C++的社区里已经拥有了Boost::regex，GRETA等很是著名的正则表达式库，但是 做为VC++自带的模板库，ATL中的正则表达式库仍然给咱们的工做提供了极大的便利。因为 ATL是微软官方发布的Library，因此它拥有良好的文档说明、严格的测试以及微软官方的 技术支持。另外在用ATL开发COM组件的时候，更能够方便地利用正则库的巨大威力。