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());