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

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

Returns the length of the specified sub-match.

## Official Specification Summary (cppreference)

```cpp
difference_type length( size_type n = 0 ) const; // (since C++11)
```

Returns the length of the specified sub-match.

If `n == 0`, the length of the entire matched expression is returned.

If `n > 0 && n < size()`, the length of `n`th sub-match is returned.

if `n >= size()`, a length of the unmatched match is returned.

The call is equivalent to `(*this)[n].length()`.

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

### Parameters

- `n` - integral number specifying which match to examine

### Return value

The length of the specified match or sub-match.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`operator[]`](https://en.cppreference.com/w/cpp/regex/match_results/operator_at): returns specified sub-match (public member function)
- [`length`](https://en.cppreference.com/w/cpp/regex/sub_match/length): returns the length of the match (if any) (public member function of `std::sub_match<BidirIt>`)

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