# std::atomic_ref<T>::fetch_min

> C++ Atlas: `cppatlas.com/w/cpp/atomic/atomic_ref/fetch_min` | Source: https://en.cppreference.com/w/cpp/atomic/atomic_ref/fetch_min | Domain: atomic | Standards: C++26

Atomically replaces the current value of the referenced object with the result of std::min of the value and arg. That is, it performs atomic minimum operation.

## Official Specification Summary (cppreference)

```cpp
// Provided only when T is an integral type other than cv bool or a pointer-to-object type

value_type fetch_min( value_type arg,
                      std::memory_order order =
                          std::memory_order_seq_cst ) const noexcept; // (since C++26)
```

Atomically replaces the current value of the referenced object with the result of `std::min` of the value and `arg`. That is, it performs atomic minimum operation. The operation is a read-modify-write operation. Memory is affected according to the value of `order`.

If `T` is a pointer type and the pointers point to different complete objects (or subobjects thereof), pointer comparison does not establish a strict weak ordering.

This overload participates in overload resolution only if `std::is_const_v<T>` is `false`.

### Parameters

- `arg` - the other argument of `std::min`
- `order` - memory order constraints to enforce

### Return value

The value immediately preceding the effects of this function in the modification order of `*this`.

### Notes

| Feature-test macro | Value | Std | Feature |
| --- | --- | --- | --- |
| `__cpp_lib_atomic_min_max` | `202403L` | (C++26) | Atomic minimum/maximum |

### Example

> Note: This section is incomplete Reason: no example

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