# std::barrier<CompletionFunction>::arrive

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

Constructs an arrival_token object associated with the phase synchronization point for the current phase. Then, decrements the expected count by n.

## Official Specification Summary (cppreference)

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

Constructs an `arrival_token` object associated with the phase synchronization point for the current phase. Then, decrements the expected count by `n`.

This function executes atomically. The call to this function strongly happens-before the start of the phase completion step for the current phase.

The behavior is undefined if `n` is less than or equal to 0 or greater than the expected count for the current barrier phase.

### Parameters

- `n` - the value by which the expected count is decreased

### Return value

The constructed `arrival_token` object.

### Exceptions

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

### Notes

This function can cause the completion step for the current phase to start.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`wait`](https://en.cppreference.com/w/cpp/thread/barrier/wait): blocks at the phase synchronization point until its phase completion step is run (public member function)

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