prg_string_regexp_match()
摘要
返回能否在指定源字符串中找到指定正则表达式的匹配,并可选地返回第一个匹配的起始位置和最大长度。
语法
prg_string_regexp_match (string, regexp, options, start_offset_ptr, match_length_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
string |
const char * |
待搜索的字符串 |
regexp |
const char * |
用于搜索的正则表达式 |
options |
int |
匹配选项(参见详情) |
start_offset_ptr |
int * |
用于返回第一个正则匹配在被搜索字符串中起始位置的内存指针。该指针值可以为 VOSC_NIL。 |
match_length_ptr |
int * |
用于返回第一个正则匹配在被搜索字符串中最大长度的内存指针。该指针值可以为 VOSC_NIL。 |
返回类型
int
找到匹配时返回 VOSC_TRUE,否则返回 VOSC_FALSE。
头文件
prg_string_funcs.h
详情
options 参数控制正则表达式的解析方式。options 应为以下一个或多个符号常量的按位 OR 组合:
PRGC_STR_REGEXP_OPT_IGNORE_CASE——表示 “a-z” 将匹配 “A-Z”,反之亦然。PRGC_STR_REGEXP_OPT_IGNORE_SUBEXP——表示正则表达式中的 “\0”–”\9” 元素不应被展开为先前遇到的括号子表达式。PRGC_STR_REGEXP_OPT_LINE_MATCH——表示仅当整个源字符串满足正则表达式时才产生匹配。PRGC_STR_REGEXP_OPT_NEWLINE_AS_CHAR——表示源字符串中的换行符(“\n”)应能被 “.” 表达式匹配。PRGC_STR_REGEXP_OPT_NOT_LINE_START——表示源字符串的开头不对应于行首,因此不会匹配 “^” 表达式。PRGC_STR_REGEXP_OPT_NOT_LINE_END——表示源字符串的结尾不对应于行尾,因此不会匹配 “$” 表达式。
start_offset_ptr 和 match_length_ptr 参数是返回值指针。若非 NIL 且存在匹配,它们分别包含匹配在源字符串中的起始位置和匹配子串的长度。