# std::counting_semaphore<LeastMaxValue>::max

> C++ Atlas: `cppatlas.com/w/cpp/thread/counting_semaphore/max` | Source: https://en.cppreference.com/w/cpp/thread/counting_semaphore/max | Domain: Concurrency support | Standards: C++20

Returns the internal counter's maximum possible value, which is greater than or equal to LeastMaxValue.

## Official Specification Summary (cppreference)

```cpp
constexpr std::ptrdiff_t max() noexcept; // (since C++20)
```

Returns the internal counter's maximum possible value, which is greater than or equal to `LeastMaxValue`.

### Return value

The internal counter's maximum possible value, as a `std::ptrdiff_t`.

### Notes

For specialization `binary_semaphore`, `LeastMaxValue` is equal to `1`.

As its name indicates, the `LeastMaxValue` is the *minimum* max value, not the *actual* max value. Thus `max()` can yield a number larger than `LeastMaxValue`.

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