PCRE是一個NFA正則引擎，不然不能提供完全與Perl一致的正則語法功能。但它同時也實現(xiàn)了DFA，只是滿足數(shù)學(xué)意義上的正則。

1. pcre_compile

原型：
#include <pcre.h>
pcre *pcre_compile(const char *pattern, int options, const char **errptr, int *erroffset, const unsigned char *tableptr);

功能：將一個正則表達(dá)式編譯成一個內(nèi)部表示，在匹配多個字符串時，可以加速匹配。其同pcre_compile2功能一樣只是缺少一個參數(shù)errorcodeptr。

參數(shù)：
pattern    正則表達(dá)式
options     為0，或者其他參數(shù)選項
errptr出錯消息
erroffset  出錯位置
tableptr   指向一個字符數(shù)組的指針，可以設(shè)置為空NULL

示例：

原型：
#include <pcre.h>
pcre *pcre_compile2(const char *pattern, int options, int *errorcodeptr, const char **errptr, int *erroffset, const unsigned char *tableptr);

功能：將一個正則表達(dá)式編譯成一個內(nèi)部表示，在匹配多個字符串時，可以加速匹配。其同pcre_compile功能一樣只是多一個參數(shù)errorcodeptr。

參數(shù)：
pattern    正則表達(dá)式
options     為0，或者其他參數(shù)選項
errorcodeptr    存放出錯碼
errptr出錯消息
erroffset  出錯位置
tableptr   指向一個字符數(shù)組的指針，可以設(shè)置為空NULL

3. pcre_config

原型：
#include <pcre.h>
int pcre_config(int what, void *where);

功能：查詢當(dāng)前PCRE版本中使用的選項信息。

參數(shù)：
what  選項名
where存儲結(jié)果的位置

示例：

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

功能：根據(jù)名字獲取捕獲的字串。

參數(shù)：
code成功匹配的模式
subject 匹配的串
ovectorpcre_exec() 使用的偏移向量
stringcount   pcre_exec()的返回值
stringname捕獲字串的名字
buffer   用來存儲的緩沖區(qū)
buffersize     緩沖區(qū)大小

示例：

原型：
#include <pcre.h>
int pcre_copy_substring(const char *subject, int *ovector, int stringcount, int stringnumber, char *buffer, int buffersize);

功能：根據(jù)編號獲取捕獲的字串。

參數(shù)：
code成功匹配的模式
subject 匹配的串
ovectorpcre_exec() 使用的偏移向量
stringcount   pcre_exec()的返回值
stringnumber   捕獲字串編號
buffer   用來存儲的緩沖區(qū)
buffersize     緩沖區(qū)大小

示例：

原型：
#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);

功能：使用編譯好的模式進(jìn)行匹配，采用的是一種非傳統(tǒng)的方法DFA，只是對匹配串掃描一次（與Perl不兼容）。

參數(shù)：
code     編譯好的模式
extra  指向一個pcre_extra結(jié)構(gòu)體，可以為NULL
subject    需要匹配的字符串
length匹配的字符串長度（Byte）
startoffset 匹配的開始位置
options     選項位
ovector    指向一個結(jié)果的整型數(shù)組
ovecsize   數(shù)組大小
workspace 一個工作區(qū)數(shù)組
wscount   數(shù)組大小

示例：

原型：
#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);

功能：使用編譯好的模式進(jìn)行匹配，采用與Perl相似的算法，返回匹配串的偏移位置。。

參數(shù)：
code     編譯好的模式
extra  指向一個pcre_extra結(jié)構(gòu)體，可以為NULL
subject    需要匹配的字符串
length匹配的字符串長度（Byte）
startoffset 匹配的開始位置
options     選項位
ovector    指向一個結(jié)果的整型數(shù)組
ovecsize   數(shù)組大小

8. pcre_free_substring

原型：
#include <pcre.h>
void pcre_free_substring(const char *stringptr);

功能：釋放pcre_get_substring()和pcre_get_named_substring()申請的內(nèi)存空間。

參數(shù)：
stringptr     指向字符串的指針

示例：

原型：
#include <pcre.h>
void pcre_free_substring_list(const char **stringptr);

功能：釋放由pcre_get_substring_list申請的內(nèi)存空間。

參數(shù)：
stringptr     指向字符串?dāng)?shù)組的指針

示例：

原型：
#include <pcre.h>
int pcre_fullinfo(const pcre *code, const pcre_extra *extra, int what, void *where);

功能：返回編譯出來的模式的信息。

參數(shù)：
code   編譯好的模式
extra  pcre_study()的返回值，或者NULL
what  什么信息
where存儲位置

示例：

原型：
#include <pcre.h>
int pcre_get_named_substring(const pcre *code, const char *subject, int *ovector, int stringcount, const char *stringname, const char **stringptr);

功能：根據(jù)編號獲取捕獲的字串。

參數(shù)：
code成功匹配的模式
subject 匹配的串
ovectorpcre_exec() 使用的偏移向量
stringcount   pcre_exec()的返回值
stringname捕獲字串的名字
stringptr     存放結(jié)果的字符串指針

示例：

原型：
#include <pcre.h>
int pcre_get_stringnumber(const pcre *code, const char *name);

功能：根據(jù)命名捕獲的名字獲取對應(yīng)的編號。

參數(shù)：
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);

功能：獲取匹配的子串。

參數(shù)：
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);

功能：獲取匹配的所有子串。

參數(shù)：
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()替換掉內(nèi)建的字符表。

參數(shù)：

示例：
Line2759 tables = pcre_maketables();

17. pcre_refcount

原型：
#include <pcre.h>
int pcre_refcount(pcre *code, int adjust);

功能：編譯模式的引用計數(shù)。

參數(shù)：
code已編譯的模式

adjust      調(diào)整的引用計數(shù)值

18. pcre_study

原型：
#include <pcre.h>
pcre_extra *pcre_study(const pcre *code, int options, const char **errptr);

功能：對編譯的模式進(jìn)行學(xué)習(xí)，提取可以加速匹配過程的信息。

參數(shù)：
code      已編譯的模式
options    選項
errptr     出錯消息

示例：
Line1797 extra = pcre_study(re, study_options, &error);

19. pcre_version

原型：
#include <pcre.h>
char *pcre_version(void);

功能：返回PCRE的版本信息。
參數(shù)：
示例：
Line1384 if (!quiet) fprintf(outfile, "PCRE version %s/n/n", pcre_version());

最新評論