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

> C++ Atlas: `cppatlas.com/w/cpp/regex/match_results/prefix` | Source: https://en.cppreference.com/w/cpp/regex/match_results/prefix | Domain: Regular expressions | Standards: C++11

Obtains a reference to the std::sub_match object representing the target sequence between the start of the beginning of the target sequence and the start of the entire match of the regular expression.

## Official Specification Summary (cppreference)

```cpp
const_reference prefix() const; // (since C++11)
```

Obtains a reference to the `std::sub_match` object representing the target sequence between the start of the beginning of the target sequence and the start of the entire match of the regular expression.

`ready()` must be `true`. Otherwise, the behavior is undefined.

### Return value

Reference to the unmatched prefix.

### Example

```cpp
#include <iostream>
#include <regex>
#include <string>

int main()
{
    std::regex re("a(a)*b");
    std::string target("baaaby");
    std::smatch sm;

    std::regex_search(target, sm, re);
    std::cout << sm.prefix().str() << '\n';
}
```

Output:

```text
b
```

### See also

- [`suffix`](https://en.cppreference.com/w/cpp/regex/match_results/suffix): returns sub-sequence between the end of the full match and the end of the target sequence (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/regex/match_results/prefix (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.