# std::latch::count_down

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

Atomically decrements the internal counter by n without blocking the caller.

## Official Specification Summary (cppreference)

```cpp
void count_down( std::ptrdiff_t n = 1 ); // (since C++20)
```

Atomically decrements the internal counter by `n` without blocking the caller.

If `n` is greater than the value of the internal counter or is negative, the behavior is undefined.

This operation strongly happens-before all calls that are unblocked on this `latch`.

### Parameters

- `n` - the value by which the internal counter is decreased

### Return value

(none)

### Exceptions

Throws `std::system_error` with an error code allowed for mutex types on error.

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