# std::stop_source::get_token

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

Returns a stop_token object associated with the stop_source's stop-state, if the stop_source has stop-state; otherwise returns a default-constructed (empty) stop_token.

## Official Specification Summary (cppreference)

```cpp
std::stop_token get_token() const noexcept; // (since C++20)
```

Returns a `stop_token` object associated with the `stop_source`'s stop-state, if the `stop_source` has stop-state; otherwise returns a default-constructed (empty) `stop_token`.

### Parameters

(none)

### Return value

A `stop_token` object, which will be empty if `this->stop_possible() == false`.

### Example

> Note: This section is incomplete Reason: no example

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