seteuid0's blog
Themed by Diary.
pcre使用

在网上找到的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   指向一个字符数组的指针,可以设置为空NULL3. 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结构体,可以为NULLsubject    需要匹配的字符串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结构体,可以为NULLsubject    需要匹配的字符串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()的返回值,或者NULLwhat         什么信息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());程序实例:[cpp] view plaincopy#define PCRE_STATIC // 静态库编译选项  #include <stdio.h>  #include <string.h>  #include <pcre.h>  #define OVECCOUNT 30 /* should be a multiple of 3 */  #define EBUFLEN 128  #define BUFLEN 1024  int main()  {  pcre  *re;  const char *error;  int  erroffset;  int  ovector[OVECCOUNT];  int  rc, i;  char  src [] = “111 Hello World 222”;   // 要被用来匹配的字符串  char  pattern [] = “(.*)</(tit)le>";              // 将要被编译的字符串形式的正则表达式  printf(“String : %s/n”, src);  printf(“Pattern: /"%s/"/n”, pattern);  re = pcre_compile(pattern,       // pattern, 输入参数,将要被编译的字符串形式的正则表达式  0,            // options, 输入参数,用来指定编译时的一些选项  &error,       // errptr, 输出参数,用来输出错误信息  &erroffset,   // erroffset, 输出参数,pattern中出错位置的偏移量  NULL);        // tableptr, 输入参数,用来指定字符表,一般情况用NULL  // 返回值:被编译好的正则表达式的pcre内部表示结构  if (re == NULL) {                 //如果编译失败,返回错误信息  printf(“PCRE compilation failed at offset %d: %s/n”, erroffset, error);  return 1;  }  rc = pcre_exec(re,            // code, 输入参数,用pcre_compile编译好的正则表达结构的指针  NULL,          // extra, 输入参数,用来向pcre_exec传一些额外的数据信息的结构的指针  src,           // subject, 输入参数,要被用来匹配的字符串  strlen(src),  // length, 输入参数, 要被用来匹配的字符串的指针  0,             // startoffset, 输入参数,用来指定subject从什么位置开始被匹配的偏移量  0,             // options, 输入参数, 用来指定匹配过程中的一些选项  ovector,       // ovector, 输出参数,用来返回匹配位置偏移量的数组  OVECCOUNT);    // ovecsize, 输入参数, 用来返回匹配位置偏移量的数组的最大大小  // 返回值:匹配成功返回非负数,没有匹配返回负数  if (rc < 0) {                     //如果没有匹配,返回错误信息  if (rc == PCRE_ERROR_NOMATCH) printf(“Sorry, no match …/n”);  else printf(“Matching error %d/n”, rc);  pcre_free(re);  return 1;  }  printf("/nOK, has matched …/n/n”);   //没有出错,已经匹配  for (i = 0; i < rc; i++) {             //分别取出捕获分组 $0整个正则公式 $1第一个()  char *substring_start = src + ovector[2*i];  int substring_length = ovector[2*i+1] - ovector[2*i];  printf("$%2d: %.*s/n", i, substring_length, substring_start);  }  pcre_free(re);                     // 编译正则表达式re 释放内存  return 0;  }  程序来自网上,看到有人不理解最后一个for循环的含义,ovector返回的是匹配字符串的偏移,包括起始偏移和结束偏移,所以就有循环内部的2*i处理。