# std::counting_semaphore<LeastMaxValue>::try_acquire

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

Tries to atomically decrement the internal counter by 1 if it is greater than 0 ; no blocking occurs regardless.

## Official Specification Summary (cppreference)

```cpp
bool try_acquire() noexcept; // (since C++20)
```

Tries to atomically decrement the internal counter by `1` if it is greater than `​0​`; no blocking occurs regardless.

### Return value

`true` if it decremented the internal counter, otherwise `false`.

### Notes

Implementations are allowed to fail to decrement the counter even if it was greater than `​0​` - i.e., they are allowed to spuriously fail and return `false`.

### See also

- [`release`](https://en.cppreference.com/w/cpp/thread/counting_semaphore/release): increments the internal counter and unblocks acquirers (public member function)
- [`acquire`](https://en.cppreference.com/w/cpp/thread/counting_semaphore/acquire): decrements the internal counter or blocks until it can (public member function)
- [`try_acquire_for`](https://en.cppreference.com/w/cpp/thread/counting_semaphore/try_acquire_for): tries to decrement the internal counter, blocking for up to a duration time (public member function)
- [`try_acquire_until`](https://en.cppreference.com/w/cpp/thread/counting_semaphore/try_acquire_until): tries to decrement the internal counter, blocking until a point in time (public member function)

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