# std::match_results<BidirIt,Alloc>::begin, std::match_results<BidirIt,Alloc>::cbegin

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

Returns an iterator to the beginning of the list of sub-matches. If match was successful, the iterator will point to the entire matched expression.

## Official Specification Summary (cppreference)

```cpp
iterator begin() noexcept; // (since C++11)
const_iterator begin() const noexcept; // (since C++11)
const_iterator cbegin() const noexcept; // (since C++11)
```

Returns an iterator to the beginning of the list of sub-matches. If match was successful, the iterator will point to the entire matched expression.

### Parameters

(none)

### Return value

Iterator to the first sub-match.

### Complexity

Constant.

### See also

- [`end`](https://en.cppreference.com/w/cpp/regex/match_results/end), [`cend`](https://en.cppreference.com/w/cpp/regex/match_results/end): returns iterator to the end of the list of sub-matches (public member function)

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