PCRE 简介

介绍

PCRE (Perl Compatible Regular Expressions) 是一个用C语言编写的正则表达式函数库。本文简要介绍PCRE的编译和使用方法。

编译

从PCRE官网下载后，解压（本人下的版本为pcre2-10.21）。仔细阅读 README 和 NON-AUTOTOOLS-BUILD，里面介绍了很多编译的方法。由于本人需要在VS下开发，因此选择CMake编译。
1. 打开 VS开发人员命令提示符，切换到CMake\bin\下，运行cmake-gui.exe
2. 设置源文件目录为PCRE的解压目录。
3. 在PCRE的解压目录下创建build文件夹，将该文件夹设置为编译目录。
4. 点击Configure按钮，会弹出选择编译器的提示框，选择VS编译器的版本，点击Finish按钮。
5. 配置成功后，会在配置列表中显示所有的配置项，这里按照实际需要修改。本人只修改了CMAKE_INSTALL_PREFIX，即安装目录，其他保持默认。若修改了配置项，则需要重新点击Configure以使之生效。
6. 点击Generate按钮，成功后会在build下生成所需要的VS工程文件和解决方案文件。
7. VS打开解决方案文件，解决方案配置为Release版本，编译工程ALL_BUILD，则会在build\Release下生成库文件。
8. 编译工程INSTALL，则会在CMAKE_INSTALL_PREFIX指定的目录下生成头文件、库文件和相应的手册。在share\doc下面会生成html形式的API说明文档。

使用

• 建立工程的时候需要配置字符长度，例如定义宏 PCRE2_CODE_UNIT_WIDTH=8
• 如果使用静态库，需要定义宏 PCRE2_STATIC
• 这里仅列出简单的使用说明，具体的API使用方法详见API说明文档。

#include "pcre2.h"
#include 
#include 

int main(void)
{
    const std::string pattern{ "\\d{3,5}" };
    int error_code = 0;
    PCRE2_SIZE error_offset = 0;
    pcre2_code *code = pcre2_compile(reinterpret_cast(pattern.c_str()), 
        PCRE2_ZERO_TERMINATED, 0, &error_code, &error_offset, NULL);
    if (code == NULL)
    {
        return -1;
    }

    const std::string subject{ "tel1:1234;tel2:3456;tel3:5678" };
    pcre2_match_data *match_data = pcre2_match_data_create_from_pattern(code, NULL);
    int rc = 0;
    int start_offset = 0;
    unsigned int match_index = 0;
    while ((rc = pcre2_match(code, 
        reinterpret_cast(subject.c_str()), subject.length(), 
        start_offset, 0, match_data, NULL)) > 0)
    {
        PCRE2_SIZE *ovector = pcre2_get_ovector_pointer(match_data);
        int i = 0;
        for (i = 0; i < rc; i++)
        {
            std::cout << "match " << ++match_index << ": "
                << std::string(subject.c_str() + ovector[2*i], ovector[2*i + 1] - ovector[2*i]) 
                << std::endl;
        }
        start_offset = ovector[2*(i-1) + 1];
    }

    return 0;
}