0.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       输入参数， 用来返回匹配位置偏移量的数组的最大大小

ovector的最后1/3个空间，即[2n~3n-1]，貌似为pcre正则匹配算法预留，不返回结果

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   正则表达式

    option    为0，或者其他参数选项

    errptr    出错信息

    erroffset 出错信息

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

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   存储结果的位置

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    缓冲区大小

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 缓冲区大小

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  数组大小

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    指向字符串的指针