1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
|
---
grand_parent: Synchronization Primitives
parent: cuda::atomic
---
# `cuda::atomic::fetch_min`
Defined in header `<cuda/atomic>`:
```cuda
template <typename T, cuda::thread_scope Scope>
__host__ __device__
T cuda::atomic<T, Scope>::fetch_min(T const& val,
cuda::std::memory_order order
= cuda::std::memory_order_seq_cst);
```
Atomically find the minimum of the value stored in the `cuda::atomic` and `val`.
The minimum is found using [`cuda::std::min`].
## Example
```cuda
#include <cuda/atomic>
__global__ void example_kernel() {
cuda::atomic<int> a(1);
auto x = a.fetch_min(0); // Operates as if unsigned.
auto y = a.load();
assert(x == 1 && y == 0);
}
```
[See it on Godbolt](https://godbolt.org/z/vMj9e5hdv){: .btn }
[`cuda::std::min`]: https://en.cppreference.com/w/cpp/algorithm/min
|