zoukankan      html  css  js  c++  java
  • PCRE函数简介和使用示例

    PCRE是一个NFA正则引擎,不然不能提供完全与Perl一致的正则语法功能。但它同时也实现了DFA,只是满足数学意义上的正则。

    PCRE提供了19个接口函数,为了简单介绍,使用PCRE内带的测试程序(pcretest.c)示例用法。

    1. pcre_compile

           原型:

             #include <pcre.h>

    pcre *pcre_compile(const char *pattern, int options, const char **errptr, int *erroffset, const unsigned char *tableptr);

    功能:将一个正则表达式编译成一个内部表示,在匹配多个字符串时,可以加速匹配。其同pcre_compile2功能一样只是缺少一个参数errorcodeptr

    参数:

    pattern    正则表达式

    options     为0,或者其他参数选项

           errptr       出错消息

            erroffset  出错位置

    tableptr   指向一个字符数组的指针,可以设置为空NULL

    示例:

    L1720     re = pcre_compile((char *)p, options, &error, &erroroffset, tables);

    2. pcre_compile2

           原型:

    #include <pcre.h>

    pcre *pcre_compile2(const char *pattern, int options, int *errorcodeptr, const char **errptr, int *erroffset, const unsigned char *tableptr);

    功能:将一个正则表达式编译成一个内部表示,在匹配多个字符串时,可以加速匹配。其同pcre_compile功能一样只是多一个参数errorcodeptr

    参数:

    pattern    正则表达式

    options     为0,或者其他参数选项

    errorcodeptr    存放出错码

           errptr       出错消息

            erroffset  出错位置

    tableptr   指向一个字符数组的指针,可以设置为空NULL

    3. pcre_config

           原型:

    #include <pcre.h>

    int pcre_config(int what, void *where);

    功能:查询当前PCRE版本中使用的选项信息。

    参数:

    what         选项名

    where       存储结果的位置

    示例:

    Line1312 (void)pcre_config(PCRE_CONFIG_POSIX_MALLOC_THRESHOLD, &rc);

     

    4. pcre_copy_named_substring

           原型:

    #include <pcre.h>

    int pcre_copy_named_substring(const pcre *code, const char *subject, int *ovector, int stringcount, const char *stringname, char *buffer, int buffersize);

    功能:根据名字获取捕获的字串。

    参数:

    code                            成功匹配的模式

    subject               匹配的串

    ovector              pcre_exec() 使用的偏移向量

    stringcount   pcre_exec()的返回值

    stringname       捕获字串的名字

    buffer                 用来存储的缓冲区

    buffersize                   缓冲区大小

    示例:

    Line2730 int rc = pcre_copy_named_substring(re, (char *)bptr, use_offsets,

                count, (char *)copynamesptr, copybuffer, sizeof(copybuffer));

    5. pcre_copy_substring

           原型:

    #include <pcre.h>

    int pcre_copy_substring(const char *subject, int *ovector, int stringcount, int stringnumber, char *buffer, int buffersize);

    功能:根据编号获取捕获的字串。

    参数:

    code                            成功匹配的模式

    subject               匹配的串

    ovector              pcre_exec() 使用的偏移向量

    stringcount   pcre_exec()的返回值

    stringnumber   捕获字串编号

    buffer                 用来存储的缓冲区

    buffersize                   缓冲区大小

    示例:

    Line2730 int rc = pcre_copy_substring((char *)bptr, use_offsets, count,

                  i, copybuffer, sizeof(copybuffer));

    6. pcre_dfa_exec

           原型:

    #include <pcre.h>

    int pcre_dfa_exec(const pcre *code, const pcre_extra *extra, const char *subject, int length, int startoffset, int options, int *ovector, int ovecsize, int *workspace, int wscount);

    功能:使用编译好的模式进行匹配,采用的是一种非传统的方法DFA,只是对匹配串扫描一次(与Perl不兼容)。

    参数:

    code                   编译好的模式

    extra         指向一个pcre_extra结构体,可以为NULL

    subject    需要匹配的字符串

    length       匹配的字符串长度(Byte)

    startoffset        匹配的开始位置

    options     选项位

    ovector    指向一个结果的整型数组

    ovecsize   数组大小

    workspace        一个工作区数组

    wscount   数组大小

    示例:

    Line2730 count = pcre_dfa_exec(re, extra, (char *)bptr, len, start_offset,

                  options | g_notempty, use_offsets, use_size_offsets, workspace,

                  sizeof(workspace)/sizeof(int));

    7. pcre_copy_substring

           原型:

    #include <pcre.h>

    int pcre_exec(const pcre *code, const pcre_extra *extra, const char *subject, int length, int startoffset, int options, int *ovector, int ovecsize);

    功能:使用编译好的模式进行匹配,采用与Perl相似的算法,返回匹配串的偏移位置。。

    参数:

    code                   编译好的模式

    extra         指向一个pcre_extra结构体,可以为NULL

    subject    需要匹配的字符串

    length       匹配的字符串长度(Byte)

    startoffset        匹配的开始位置

    options     选项位

    ovector    指向一个结果的整型数组

    ovecsize   数组大小

    8. pcre_free_substring

           原型:

    #include <pcre.h>

    void pcre_free_substring(const char *stringptr);

    功能:释放pcre_get_substring()和pcre_get_named_substring()申请的内存空间。

    参数:

    stringptr            指向字符串的指针

    示例:

    Line2730        const char *substring;

    int rc = pcre_get_substring((char *)bptr, use_offsets, count,

                  i, &substring);

    ……

    pcre_free_substring(substring);

    9. pcre_free_substring_list

           原型:

    #include <pcre.h>

    void pcre_free_substring_list(const char **stringptr);

    功能:释放由pcre_get_substring_list申请的内存空间。

    参数:

    stringptr            指向字符串数组的指针

    示例:

    Line2773        const char **stringlist;

    int rc = pcre_get_substring_list((char *)bptr, use_offsets, count,

    ……

    pcre_free_substring_list(stringlist);

    10. pcre_fullinfo

           原型:

    #include <pcre.h>

    int pcre_fullinfo(const pcre *code, const pcre_extra *extra, int what, void *where);

    功能:返回编译出来的模式的信息。

    参数:

    code          编译好的模式

    extra         pcre_study()的返回值,或者NULL

    what         什么信息

    where       存储位置

    示例:

    Line997          if ((rc = pcre_fullinfo(re, study, option, ptr)) < 0)

    fprintf(outfile, "Error %d from pcre_fullinfo(%d)/n", rc, option);

    }

    11. pcre_get_named_substring

           原型:

    #include <pcre.h>

    int pcre_get_named_substring(const pcre *code, const char *subject, int *ovector, int stringcount, const char *stringname, const char **stringptr);

    功能:根据编号获取捕获的字串。

    参数:

    code                            成功匹配的模式

    subject               匹配的串

    ovector              pcre_exec() 使用的偏移向量

    stringcount   pcre_exec()的返回值

    stringname       捕获字串的名字

    stringptr     存放结果的字符串指针

    示例:

    Line2759        const char *substring;

    int rc = pcre_get_named_substring(re, (char *)bptr, use_offsets,

                count, (char *)getnamesptr, &substring);

    12. pcre_get_stringnumber

           原型:

    #include <pcre.h>

    int pcre_get_stringnumber(const pcre *code, const char *name);

    功能:根据命名捕获的名字获取对应的编号。

    参数:

    code                            成功匹配的模式

    name                 捕获名字

    13. pcre_get_substring

           原型:

    #include <pcre.h>

    int pcre_get_substring(const char *subject, int *ovector, int stringcount, int stringnumber, const char **stringptr);

    功能:获取匹配的子串。

    参数:

    subject       成功匹配的串

    ovector       pcre_exec() 使用的偏移向量

    stringcount    pcre_exec()的返回值

    stringnumber  获取的字符串编号

    stringptr      字符串指针

    14. pcre_get_substring_list

           原型:

    #include <pcre.h>

    int pcre_get_substring_list(const char *subject, int *ovector, int stringcount, const char ***listptr);

    功能:获取匹配的所有子串。

    参数:

    subject       成功匹配的串

    ovector       pcre_exec() 使用的偏移向量

    stringcount    pcre_exec()的返回值

    listptr             字符串列表的指针

    15. pcre_info

           原型:

    #include <pcre.h>

    int pcre_info(const pcre *code, int *optptr, int *firstcharptr);

    已过时,使用pcre_fullinfo替代。

    16. pcre_maketables

           原型:

    #include <pcre.h>

    const unsigned char *pcre_maketables(void);

    功能:生成一个字符表,表中每一个元素的值不大于256,可以用它传给pcre_compile()替换掉内建的字符表。

    参数:

    示例:

    Line2759 tables = pcre_maketables();

    17. pcre_refcount

           原型:

    #include <pcre.h>

    int pcre_refcount(pcre *code, int adjust);

    功能:编译模式的引用计数。

    参数:

    code       已编译的模式

    adjust      调整的引用计数值

    18. pcre_study

           原型:

    #include <pcre.h>

    pcre_extra *pcre_study(const pcre *code, int options, const char **errptr);

    功能:对编译的模式进行学习,提取可以加速匹配过程的信息。

    参数:

    code      已编译的模式

    options    选项

    errptr     出错消息

    示例:

    Line1797 extra = pcre_study(re, study_options, &error);

    19. pcre_version

           原型:

    #include <pcre.h>

    char *pcre_version(void);

    功能:返回PCRE的版本信息。

    参数:

    示例:

    Line1384 if (!quiet) fprintf(outfile, "PCRE version %s/n/n", pcre_version());

     20.pcre_exec

      原型:

    #include <pcre.h>
    int
    pcre_exec(const pcre *code, const pcre_extra *extra, const char *subject, int length, int startoffset, int options, int *ovector, int ovecsize);

    功能:用来检查某个字符串是否与指定的正则表达式匹配

    参数: code, 输入参数,用pcre_compile编译好的正则表达结构的指针

         extra, 输入参数,用来向pcre_exec传一些额外的数据信息的结构的指针

         subject, 输入参数,要被用来匹配的字符串

         length, 输入参数, 要被用来匹配的字符串的指针

         startoffset, 输入参数,用来指定subject从什么位置开始被匹配的偏移量

         options, 输入参数, 用来指定匹配过程中的一些选项

       ovector, 输出参数,用来返回匹配位置偏移量的数组

         ovecsize, 输入参数, 用来返回匹配位置偏移量的数组的最大大小

    返回值:匹配成功返回非负数,匹配返回负数

    有志者事竟成
  • 相关阅读:
    Google新闻昨晚发生全球服务中断 波及国内 狼人:
    德国"反黑客"法出炉:拥有黑客工具是非法的 狼人:
    百付宝携手瑞星 打造零风险支付平台 狼人:
    四月新增电脑病毒180万 2千万台次电脑遭攻击 狼人:
    PDF文件和Word文档面临更多网络安全威胁 狼人:
    麻省理工学生令计算机系统升级不需重启 狼人:
    nullnullIOS控件AlertView的使用
    设置源ARM中断处理_S3C2440
    软件授权码Python之道Python连接MYSQL数据库和发送邮件
    目标文件符号《深入理解计算机系统》笔记(三)链接知识【附图】
  • 原文地址:https://www.cnblogs.com/dancheblog/p/3528367.html
Copyright © 2011-2022 走看看