# std::match_results<BidirIt,Alloc>::str

< cpp‎ | regex‎ | match results

string_type str( size_type n = 0 ) const; |  | (C++11 起)

返回表示指示的子匹配的字符串。

若 n == 0 ，则返回表示整个匹配的表达式的字符串。

若 n > 0 && n < size() ，则返回表示第 n 个子匹配的字符串。

若 n >= size() ，则返回表示不匹配的匹配的字符串。

调用等价于 string_type((*this)[n]) 。

### 参数

n | - | 指定要返回哪个匹配的整数

### 返回值

返回表示指定匹配或子匹配的字符串。

### 示例

    #include <iostream>
    #include <regex>
    #include <string>

    int main()
    {
        std::string target("baaaby");
        std::smatch sm;

        std::regex re1("a(a)*b");
        std::regex_search(target, sm, re1);
        std::cout << "entire match: " << sm.str(0) << '\n'
                  << "submatch #1: " << sm.str(1) << '\n';

        std::regex re2("a(a*)b");
        std::regex_search(target, sm, re2);
        std::cout << "entire match: " << sm.str(0) << '\n'
                  << "submatch #1: " << sm.str(1) << '\n';

    }

输出：

    entire match: aaab
    submatch #1: a
    entire match: aaab
    submatch #1: aa

### 参阅

operator[] | 返回指定的子匹配 (公开成员函数)