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 且存在匹配,它们分别包含匹配在源字符串中的起始位置和匹配子串的长度。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com