sub_match 類別

發行項
06/09/2015

描述相符項目。

template<class BidIt>
    class sub_match
        : public std::pair<BidIt, BidIt> {
public:
    bool matched;
    int compare(const sub_match& right) const;
    int compare(const basic_string<value_type>& right) const;
    int compare(const value_type *right) const;
    difference_type length() const;
    operator basic_string<value_type>() const;
    basic_string<value_type> str() const;
    typedef typename iterator_traits<BidIt>::value_type value_type;
    typedef typename iterator_traits<BidIt>::difference_type difference_type;
    typedef BidIt iterator;
    };

參數

BidIt
相符的 Iterator 型別。

備註

樣板類別描述指定字元序列符合呼叫中擷取的群組到 regex_match 函式或 regex_search 函式的物件。型別 match_results 類別物件來保存的陣列，這些物件會用於搜尋的規則運算式的每個擷取的群組。

如果擷取的群組未符合物件的資料成員 matched 保留 false，，和兩個 Iterator first 和 second (繼承自基底 std::pair)。如果擷取的群組相符，套用 matched ，對第一個字元的 Iterator first 會在符合擷取群組的目標序列和 Iterator second 點到最後一個字元的位置在符合擷取群組的目標序列。為成員套用 matched 的長度為零的遊戲注意，兩個 Iterator 是相等的，因此，都指向符合項目的位置。

長度為零的相符項目時，可能會發生擷取的群組僅包含判斷提示時，允許零個迴圈或迴圈。例如：

「^」與目標序列「a」;使用擷取的群組 0 對應的 sub_match 物件來保存 Iterator 這兩個對第一個字元的點在序列。

「b (a*) b」與目標序列「bb」;使用擷取的群組 1 對應的 sub_match 物件來保存 Iterator 這兩個對第二個字元的點在序列。