VC使用DEELX正则引擎-DLL方式

DEELX 是一个在 C++ 环境下的与 Perl 兼容的正则表达式引擎。是 RegExLab 开展的一个研究开发项目。相比于GRETA很Boost来说是一个接口相对简单易用的正在引擎。其基本特点：

支持与 Perl 兼容的正则表达式语法。
支持 IGNORECASE, SINGLELINE, MULTILINE 等常见匹配模式。
兼容性强，能在 vc6, vc7, vc8, gcc, Turbo C++ 等大多数 C++ 环境编译。
支持命名分组，条件表达式，递归表达式等多种高级特性。（1.2版本新特点）

 

与 GRETA、boost 相比，DEELX 独到之处：

完全使用模版库编写，支持 char, wchar_t, int 等以及其他基类型版本。
全部代码位于一个头文件（.h）中， 比任何引擎都使用简单和方便。
支持从右向左匹配模式，可从文本结束位置向前搜索匹配。
可防止零长度子匹配循环无限次而产生的死循环。（1.2版本新特点）

 

这是RegExLab的说法。我们使用还是要根据自己的项目要求合理选择。后续将会做一个GRETA Demo，可做一些对比。DEELX本身只是由一个头文件构成，全是模板，里面实现了一个内部的内存管理模块，感兴趣的可以自己阅读。使用DLL需要一个头文件，DEELX也进行了封装。我们先看看头文件的内容。

 

// flags #ifndef _REGEX_FLAGS_DEFINED enum REGEX_FLAGS { NO_FLAG = 0, SINGLELINE = 0x01, MULTILINE = 0x02, GLOBAL = 0x04, IGNORECASE = 0x08, RIGHTTOLEFT = 0x10, EXTENDED = 0x20, }; #define _REGEX_FLAGS_DEFINED #endif

 

首先定义一些标志位，默认是0。例如SINGLELINE，MULTLINE定义了单行和多行匹配。

 

#ifdef LIBDEELX_EXPORTS #define DEELX_API __declspec( dllexport ) #else #define DEELX_API __declspec( dllimport ) #endif

 

封装一下DLL导出导入关键字，DLL源文件中使用的是__declspec(dllexport)。使用此DLL的源文件中应该使用__declspec(dllixport)。通过开关宏LIBDEELX_EXPORTS区分。

 

其后又用宏LOAD_DEELX_RUNTIME来区分是运行时或非运行时，运行时声明需要导出的函数表，非运行时使用typedef定义了许多函数指针类型，可以简化引入头文件时的工作。我们不选用。

 

// create & free DEELX_API regexp_handle __stdcall regexp_create (); DEELX_API regexp_handle __stdcall regexpw_create(); DEELX_API result_handle __stdcall result_create (); DEELX_API void __stdcall regexp_free (regexp_handle handle); DEELX_API void __stdcall regexpw_free (regexp_handle handle); DEELX_API void __stdcall result_free (result_handle result); // compile & match DEELX_API void __stdcall regexp_compile (regexp_handle handle, const char * pattern, int flag); DEELX_API void __stdcall regexpw_compile (regexp_handle handle, const unsigned short * pattern, int flag); DEELX_API void __stdcall regexp_match (regexp_handle handle, const char * text , int startpos, result_handle result); DEELX_API void __stdcall regexpw_match (regexp_handle handle, const unsigned short * text , int startpos, result_handle result); DEELX_API int __stdcall regexp_replace (regexp_handle handle, const char * text , const char * replaceto, int startpos, int times, char * buffer, int bufsize); DEELX_API int __stdcall regexpw_replace (regexp_handle handle, const unsigned short * text , const unsigned short * replaceto, int startpos, int times, unsigned short * buffer, int bufsize); // get result DEELX_API int __stdcall regexp_namednumber (regexp_handle handle, const char * name); DEELX_API int __stdcall regexpw_namednumber(regexp_handle handle, const unsigned short * name); DEELX_API int __stdcall result_ismatched (result_handle result); DEELX_API int __stdcall result_start (result_handle result); DEELX_API int __stdcall result_end (result_handle result); DEELX_API int __stdcall result_maxgroup (result_handle result); DEELX_API int __stdcall result_groupstart (result_handle result, int number); DEELX_API int __stdcall result_groupend (result_handle result, int number);

 

函数指针类型：

 

// create & free typedef regexp_handle (__stdcall * fn_regexp_create )(); typedef regexp_handle (__stdcall * fn_regexpw_create)(); typedef result_handle (__stdcall * fn_result_create )(); typedef void (__stdcall * fn_regexp_free )(regexp_handle handle); typedef void (__stdcall * fn_regexpw_free )(regexp_handle handle); typedef void (__stdcall * fn_result_free )(result_handle result); // compile & match typedef void (__stdcall * fn_regexp_compile )(regexp_handle handle, const char * pattern, int flag); typedef void (__stdcall * fn_regexpw_compile )(regexp_handle handle, const unsigned short * pattern, int flag); typedef void (__stdcall * fn_regexp_match )(regexp_handle handle, const char * text , int startpos, result_handle result); typedef void (__stdcall * fn_regexpw_match )(regexp_handle handle, const unsigned short * text , int startpos, result_handle result); typedef int (__stdcall * fn_regexp_replace )(regexp_handle handle, const char * text , const char * replaceto, int startpos, int times, char * buffer, int bufsize); typedef int (__stdcall * fn_regexpw_replace )(regexp_handle handle, const unsigned short * text , const unsigned short * replaceto, int startpos, int times, unsigned short * buffer, int bufsize); // get result typedef int (__stdcall * fn_regexp_namednumber )(regexp_handle handle, const char * name); typedef int (__stdcall * fn_regexpw_namednumber)(regexp_handle handle, const unsigned short * name); typedef int (__stdcall * fn_result_ismatched )(result_handle result); typedef int (__stdcall * fn_result_start )(result_handle result); typedef int (__stdcall * fn_result_end )(result_handle result); typedef int (__stdcall * fn_result_maxgroup )(result_handle result); typedef int (__stdcall * fn_result_groupstart )(result_handle result, int number); typedef int (__stdcall * fn_result_groupend )(result_handle result, int number);

 

VC中经常发现不一致的命名方式，Windows使用的匈牙利命名方式与源文件不符，而且我们做个简单的Demo用不着那么多函数指针。所有自己定义几个需要的即可。

 

typedef regexp_handle (__stdcall *RegexpCreate)(); typedef result_handle (__stdcall *ResultCreate)(); typedef void (__stdcall *RegexpFree)(regexp_handle); typedef void (__stdcall *ResultFree)(result_handle) ; typedef void (__stdcall *RegexpCompile)(regexp_handle, const char *, int); typedef void (__stdcall *RegexpMatch)(regexp_handle, const char * , int , result_handle); typedef int (__stdcall *ResultIsmatched)(result_handle); typedef int (__stdcall *ResultStart)(result_handle); typedef int (__stdcall *ResultEnd)(result_handle);

 

__stdcall一定要放在括号内，不然编译器在第一个空格开始把后面的当做需要定义的，语法错误。

 

写一个main函数，首先加载DLL，然后获取DLL中的函数位置，相当于了初始化函数指针。然后验证正在表达式，最后卸载DLL。

 

int main(int argc, char** argv){ if (argc != 3) { printf("input error!/nformat: coretest regular string /n"); return 0; } HINSTANCE hDll =LoadLibrary("libdeelx.dll"); RegexpCreate create =(RegexpCreate)GetProcAddress(hDll,"regexp_create"); ResultCreate createResult =(ResultCreate)GetProcAddress(hDll,"result_create"); RegexpFree regexpFree = (RegexpFree)GetProcAddress(hDll, "regexp_free"); ResultFree resultFree = (ResultFree)GetProcAddress(hDll, "result_free"); RegexpCompile compile = (RegexpCompile)GetProcAddress(hDll, "regexp_compile"); RegexpMatch match = (RegexpMatch)GetProcAddress(hDll, "regexp_match"); ResultIsmatched isMathched = (ResultIsmatched)GetProcAddress(hDll, "result_ismatched"); ResultStart start = (ResultStart)GetProcAddress(hDll, "result_start"); ResultEnd end = (ResultEnd)GetProcAddress(hDll, "result_end"); regexp_handle h = create(); result_handle r = createResult(); compile(h, *(argv + 1), 0); match(h, *(argv + 2), 0, r); printf("%s match %s result : %d", *(argv + 1), *(argv + 2), isMathched(r)); regexpFree(h); resultFree(r); FreeLibrary(hDll); return 0; }

 

如果没有__stdcall会怎么样？悲剧地看到这样的错误- The value of ESP was not properly saved across a function call.  This is usually a result of calling a function declared with one calling convention with a function pointer declared with a different calling convention.为什么呢？因为VC默认使用_cdecl，而DLL中使用的是_stdcall，栈到底谁清就搞乱了，能乱来么？

 

如果DLL名字写错了怎么样？悲剧地看到访问错误。为什么呢？因为函数指针都指向的0x0000000位置，当然错啦。

 

你可以从Codeproject上下载源码。

 

http://www.codeproject.com/KB/library/deelx.aspxs