编程帮助 - MatchResult 类

DEELX

MatchResult 类

回到:目录 | 上一页:ReleaseString 方法 | 下一页:IsMatched 属性


概述

MatchResult 类用来记录匹配结果。

MatchResult 对象中记录了所匹配到的字符串在整个文本中的位置,以及各个捕获组的位置。

要获取命名分组捕获的字符串,先通过 CRegexpT 类中的 GetNamedGroupNumber 属性 获取分组编号,然后通过 MatchResult 对象获取捕获组信息。


成员方法

IsMatched 属性   判断是否匹配成功,返回非 0 值表示匹配成功。

GetStart 属性
  获取匹配到的子字符串开始位置,如果未匹配成功则返回一个负值。

GetEnd 属性
  获取匹配到的子字符串结束位置,如果未匹配成功则返回一个负值。

GetGroupStart 属性
  获取指定分组的开始位置,如果该分组未捕获或者未匹配成功,则返回一个负值。

GetGroupEnd 属性
  获取指定分组的结束位置,如果该分组未捕获或者未匹配成功,则返回一个负值。

MaxGroupNumber 属性
  返回表达式中最大的分组编号。


类声明
class MatchResult
{
public:
    int IsMatched() const;

public:
    int GetStart() const;
    int GetEnd  () const;

public:
    int MaxGroupNumber() const;
    int GetGroupStart(int nGroupNumber) const;
    int GetGroupEnd  (int nGroupNumber) const;
};

 

regexlab.com © 2005 - 2006