pcre函數具體解析。本站提示廣大學習愛好者:(pcre函數具體解析)文章只能為提供參考,不一定能成為您想要的結果。以下是pcre函數具體解析正文
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());