# std::experimental::latch::count_down

> C++ Atlas: `cppatlas.com/w/cpp/experimental/latch/count_down` | Source: https://en.cppreference.com/w/cpp/experimental/latch/count_down | Domain: Technical specifications

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

## Official Specification Summary (cppreference)

```cpp
void count_down( ptrdiff_t n = 1 ); // (1) (concurrency TS)
```

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 synchronizes with all calls that block on this latch and all `is_ready` calls on this latch that returns `true`.

### Parameters

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

### Return value

(none)

### Exceptions

Throws nothing.

---
Attribution: content from https://en.cppreference.com/w/cpp/experimental/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.