pcre函数详细解析

 更新时间:2013年09月23日 08:56:04   作者:  
PCRE提供了19个接口函数,为了简单介绍,使用PCRE内带的测试程序(pcretest.c)示例用法

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

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 匹配的串
ovectorpcre_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 匹配的串
ovectorpcre_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 匹配的串
ovectorpcre_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成功匹配的串
ovectorpcre_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成功匹配的串
ovectorpcre_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());

相关文章

  • C/C++ 实现动态资源文件释放的方法

    C/C++ 实现动态资源文件释放的方法

    当我们开发Windows应用程序时,通常会涉及到使用资源(Resource)的情况。资源可以包括图标、位图、字符串等,它们以二进制形式嵌入到可执行文件中,这篇文章主要介绍了C/C++ 实现动态资源文件释放,需要的朋友可以参考下
    2023-12-12
  • 最新C语言自定义类型详解

    最新C语言自定义类型详解

    生活当中有很多物品是不能简单的用整型、浮点型、字符型来区分,它们常常是复杂的集合,比如人,一个人拥有年龄,身高、体重、学历......等信息,我们可以用结构体来实现准确描述人这种复杂集合,这篇文章主要介绍了C语言 自定义类型,需要的朋友可以参考下
    2023-01-01
  • VS Code如何编写C/C++程序的实现步骤

    VS Code如何编写C/C++程序的实现步骤

    本文主要介绍了VS Code如何编写C/C++程序的实现步骤,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-09-09
  • C++实现LeetCode(114.将二叉树展开成链表)

    C++实现LeetCode(114.将二叉树展开成链表)

    这篇文章主要介绍了C++实现LeetCode(114.将二叉树展开成链表),本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-07-07
  • VScode配置C++运行环境的完整步骤

    VScode配置C++运行环境的完整步骤

    这篇文章主要给大家介绍了关于VScode配置C++运行环境的完整步骤,文中通过图文介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • C++实现LeetCode(89.格雷码)

    C++实现LeetCode(89.格雷码)

    这篇文章主要介绍了C++实现LeetCode(89.格雷码),本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-07-07
  • C/C++实现发送与接收HTTP/S请求的示例代码

    C/C++实现发送与接收HTTP/S请求的示例代码

    HTTP(Hypertext Transfer Protocol)是一种用于传输超文本的协议,它是一种无状态的、应用层的协议,用于在计算机之间传输超文本文档,通常在 Web 浏览器和 Web 服务器之间进行数据通信,本文给大家介绍了C/C++发送与接收HTTP/S请求,需要的朋友可以参考下
    2023-11-11
  • 详解c++种gmock单元测试框架

    详解c++种gmock单元测试框架

    这篇文章我们给大家分享了关于c++种gmock单元测试框架的相关知识点内容,有兴趣的朋友们学习下。
    2018-08-08
  • C语言文件操作函数freopen详细解析

    C语言文件操作函数freopen详细解析

    替换一个流,或者说重新分配文件指针,实现重定向。如果stream流已经打开,则先关闭该流。如果该流已经定向,则freopen将会清除该定向。此函数一般用于将一个指定的文件打开一个预定义的流:标准输入、标准输出或者标准出错
    2013-10-10
  • QT中大部分部件如何使用举例详解

    QT中大部分部件如何使用举例详解

    QWidget类是所有用户界面对象的基类,被称为基础窗口部件,下面这篇文章主要给大家介绍了关于QT中大部分部件如何使用的相关资料,需要的朋友可以参考下
    2022-06-06

最新评论