Boost C++ 库

match_results();

match_results(match_results< BidiIter > const & that);

~match_results();

match_results< BidiIter > & operator=(match_results< BidiIter > const & that);

size_type size() const;

如果 *this 代表成功匹配的结果，则返回比最近用于匹配的正则表达式中的标记子表达式数量多一个的值。否则返回 0。

bool empty() const;

返回 size() == 0。

difference_type length(size_type sub = 0) const;

返回 (*this)[sub].length()。

difference_type position(size_type sub = 0) const;

如果 !(*this)[sub].matched 则返回 -1。否则返回 std::distance(base, (*this)[sub].first)，其中 base 是被搜索序列的起始迭代器。[注意 - 除非这是与 regex_iterator 的重复搜索的一部分，否则 base 与 prefix().first 相同 - 结束注意]

string_type str(size_type sub = 0) const;

返回 (*this)[sub].str()。

template<typename Sub> const_reference operator[](Sub const & sub) const;

返回表示与标记子表达式 sub 匹配的序列的 sub_match 对象。如果 sub == 0，则返回表示与整个正则表达式匹配的序列的 sub_match 对象。如果 sub >= size()，则返回一个表示未匹配子表达式的 sub_match 对象。

const_reference prefix() const;

返回表示从被匹配/搜索的字符串开头到找到的匹配开头的字符序列的 sub_match 对象。

const_reference suffix() const;

返回表示从找到的匹配结尾到被匹配/搜索的字符串结尾的字符序列的 sub_match 对象。

const_iterator begin() const;

返回一个起始迭代器，该迭代器枚举 *this 中存储的所有标记子表达式匹配。

const_iterator end() const;

返回一个终止迭代器，该迭代器枚举 *this 中存储的所有标记子表达式匹配。

operator bool_type() const;

如果 (*this)[0].matched，则返回 true，否则返回 false。

bool operator!() const;

如果 empty() || !(*this)[0].matched，则返回 true，否则返回 false。

regex_id_type regex_id() const;

返回最近与此 match_results 对象一起使用的 basic_regex 对象的 ID。

nested_results_type const & nested_results() const;

返回嵌套 match_results 元素的 Sequence。

template<typename Format, typename OutputIterator> 
  OutputIterator 
  format(OutputIterator out, Format const & fmt, 
         regex_constants::match_flag_type flags = regex_constants::format_default, 
         unspecified = 0) const;

如果 Format 建模 ForwardRange 或是一个空终止字符串，则此函数将 fmt 中的字符序列复制到 OutputIterator out。对于 fmt 中的每个格式说明符或转义序列，将该序列替换为它所表示的字符或字符集，或者它所引用的 *this 中的序列。flags 中指定的位掩码决定了哪些格式说明符或转义序列被识别。默认情况下，这是 ECMA-262（ECMAScript Language Specification，Chapter 15 part 5.4.11 String.prototype.replace）使用的格式。

否则，如果 Format 建模 Callable<match_results<BidiIter>, OutputIterator, regex_constants::match_flag_type>，则此函数返回 fmt(*this, out, flags)。

否则，如果 Format 建模 Callable<match_results<BidiIter>, OutputIterator>，则此函数返回 fmt(*this, out)。

否则，如果 Format 建模 Callable<match_results<BidiIter> >，则此函数返回 std::copy(x.begin(), x.end(), out)，其中 x 是调用 fmt(*this) 的结果。

template<typename OutputIterator> 
  OutputIterator 
  format(OutputIterator out, char_type const * fmt, 
         regex_constants::match_flag_type flags = regex_constants::format_default) const;

这是一个重载的成员函数，为方便起见提供。它仅在接受的参数不同时与上述函数有所区别。

template<typename Format, typename OutputIterator> 
  string_type format(Format const & fmt, 
                     regex_constants::match_flag_type flags = regex_constants::format_default, 
                     unspecified = 0) const;

如果 Format 建模 ForwardRange 或是一个空终止字符串，则此函数返回 fmt 字符序列的副本。对于 fmt 中的每个格式说明符或转义序列，将该序列替换为它所表示的字符或字符集，或者它所引用的 *this 中的序列。 flags 中指定的位掩码决定了哪些格式说明符或转义序列被识别。默认情况下，这是 ECMA-262（ECMAScript Language Specification，Chapter 15 part 5.4.11 String.prototype.replace）使用的格式。

否则，如果 Format 建模 Callable<match_results<BidiIter>, OutputIterator, regex_constants::match_flag_type>，则此函数返回一个 string_type 对象 x，该对象通过调用 fmt(*this, out, flags) 填充，其中 out 是 x 的一个 back_insert_iterator。

否则，如果 Format 建模 Callable<match_results<BidiIter>, OutputIterator>，则此函数返回一个 string_type 对象 x，该对象通过调用 fmt(*this, out) 填充，其中 out 是 x 的一个 back_insert_iterator。

否则，如果 Format 建模 Callable<match_results<BidiIter> >，则此函数返回 fmt(*this)。

string_type format(char_type const * fmt, 
                   regex_constants::match_flag_type flags = regex_constants::format_default) const;

这是一个重载的成员函数，为方便起见提供。它仅在接受的参数不同时与上述函数有所区别。

void swap(match_results< BidiIter > & that);

交换两个 match_results 对象的内容。保证不抛出异常。

template<typename Arg> match_results< BidiIter > & let(Arg const & arg);

待文档化