Click here to Skip to main content
15,867,594 members
Articles / Desktop Programming / ATL
Article

Use regular expression in your C++ program

Rate me:
Please Sign up or sign in to vote.
3.36/5 (16 votes)
25 Jan 20012 min read 205.2K   40   10
how to use the Microsoft regular expression object in your C++ program

Introduction

Regular expressions provide a convenient way to specify complicated string pattern for search, replace or validate the text input. Since it is very useful, many people wrote their own library. Many libraries I found are buggy and it takes a lot of time to debug source code. However, actually you do not need to search any more, since there is already one built in your computer for free – the regular expression parser written by Microsoft.

As many other utilities, Microsoft provides this functionality using COM interface. It is easy to find this COM server object, named Microsoft VBScript Regular Expressions 5.5, with the tool oleview:

One problem is that there is no type library associated with this DLL. Fortunately it is not a big deal since we have the IDL definition. From OleView, save the IDL definition into a file and use MIDL to compile it, you will get type library. After that, we can use this type library within our C++ program. Suppose we have this file named RegExp.tlb.

Image 1

Using regular expression

You can find all the documentation in either MSDN or the URL http://msdn.microsoft.com/scripting/default.htm?/scripting/vbscript/doc/vsobjregexp.htm. Though it is for scripting, you can still use them directly with the help of the newly-added keyword #import since Visual C++ 6. Generally you define a pattern, then you can test this pattern against the input string. or exacute to see whether they are any matches.

To demonstrate its usage, we wrote a custome DDX routine to verify the input of a control in a dialog. The function prototype is listed as following:

void WINAPI DDX_RegExp(CDataExchange* pDX, int nIDC, LPCTSTR lpszPattern, CString& value);

If the control input exactly matches the specified pattern(lpszPattern), the validation is passed otherwise an message box will pop up.

#import "RegExp.tlb" no_namespace
...
void AFXAPI DDX_RegExp(CDataExchange* pDX, int nIDC, LPCTSTR lpszPattern, CString& value)
{
   try {
      static IRegExpPtr regExp( __uuidof(RegExp) );
      regExp->Pattern = _bstr_t(lpszPattern);
    
      HWND hWndCtrl = pDX->PrepareEditCtrl(nIDC);
      if (pDX->m_bSaveAndValidate)
      {
          int nLen = ::GetWindowTextLength(hWndCtrl);
          ::GetWindowText(hWndCtrl, value.GetBufferSetLength(nLen),nLen+1);
          value.ReleaseBuffer();

          //now we verify it
          if ( regExp->Test( (LPCTSTR)value) )
          {
              IMatchCollectionPtr matches=regExp->Execute((LPCTSTR)value);
              if ( matches->Count== 1)
              {
                  IMatchPtr match = matches->Item[0];
                  if ( match->FirstIndex==0 && match->Length == value.GetLength() )
                  {
                    return;
                  }
              }
          }
          CString strMsg = CString("The input does not exactly have the pattern ") + lpszPattern;
          pDX->m_pDlgWnd->MessageBox(strMsg);
          pDX->PrepareEditCtrl(nIDC);
          pDX->Fail();
      }
      else
      {
      }
    }
    catch (_com_error& e)
    {
        AfxMessageBox( e.ErrorMessage() );
    }
}

In the code above, we first use Test method to see whether there is a match. If there is one, we use Execute method to retrieve all the matches. There should be only one match.

After we define that, we can use this function in our MFC application. Note that you must initialize the COM library first in your application. The following will validate an input box to see if it matches the phone number format:

DDX_RegExp(pDX, IDC_INPUT, _T("\\d{3}-\\d{3}-\\d{4}"), m_strInput);

In this way, you can write validation code for more complicated pattern. The COM makes things a lot easier.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionSubMatches? Pin
vikee7-Sep-09 5:41
vikee7-Sep-09 5:41 
AnswerRe: SubMatches? Pin
vikee7-Sep-09 5:58
vikee7-Sep-09 5:58 
GeneralGood work... Pin
benny_thomas038-Jun-08 3:04
benny_thomas038-Jun-08 3:04 
QuestionCompiling the IDL? Pin
biopsy21-Aug-07 16:27
biopsy21-Aug-07 16:27 
QuestionVC++ Project? Pin
vito3332-Jun-05 3:41
vito3332-Jun-05 3:41 
GeneralDistribution queston Pin
Anonymous14-May-05 11:44
Anonymous14-May-05 11:44 
GeneralUser Brakpoint Pin
Anonymous9-Nov-04 9:45
Anonymous9-Nov-04 9:45 
GeneralGetting the headers for RegExp 1.0 Pin
Member 37674816-Sep-04 9:04
Member 37674816-Sep-04 9:04 
GeneralRe: Getting the headers for RegExp 1.0 Pin
brianmaguire23-Sep-04 9:53
brianmaguire23-Sep-04 9:53 
GeneralRe: Getting the headers for RegExp 1.0 Pin
Vince Gatto26-Sep-04 9:27
sussVince Gatto26-Sep-04 9:27 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.