Sword pcre库函数学习一

Posted zhanggaofeng

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Sword pcre库函数学习一相关的知识,希望对你有一定的参考价值。

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

 


以上是关于Sword pcre库函数学习一的主要内容,如果未能解决你的问题,请参考以下文章

Sword pcre库函数学习三

Sword pcre库使用

Sword cjson库函数使用

译丨Yarn - Javascript 新一代套件管理

Sword - 为 Kotlin 函数增加代理功能

nginx源码学习