# std::experimental::atomic_shared_ptr<T>::store

> C++ Atlas: `cppatlas.com/w/cpp/experimental/atomic_shared_ptr/store` | Source: https://en.cppreference.com/w/cpp/experimental/atomic_shared_ptr/store | Domain: Technical specifications | Standards: C++20, C++26

Atomically replaces the current value with desired. Memory is affected according to the value of order.

## Official Specification Summary (cppreference)

```cpp
void store( shared_ptr<T> desired, std::memory_order order = std::memory_order_seq_cst ) noexcept;
```

Atomically replaces the current value with `desired`. Memory is affected according to the value of `order`.

`order` must be one of `std::memory_order_relaxed`, `std::memory_order_release` or `std::memory_order_seq_cst`. Otherwise the behavior is undefined.

### Parameters

- `desired` - the `shared_ptr` to store into the atomic variable
- `order` - memory order constraints to enforce

### Return value

(none)

### Remarks

All changes to the `atomic_shared_ptr` object itself, and all associated `use_count` increments, are guaranteed to be performed atomically. Associated `use_count` decrements take place after the atomic operation, but are not required to be part of it. Any associated destruction or deallocation operations take place after the atomic operation and are not part of it.

### See also

- [`operator=`](https://en.cppreference.com/w/cpp/experimental/atomic_shared_ptr/operator=): stores a value into an `atomic_shared_ptr` object (public member function)
- [`std::atomic_is_lock_free(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic) (deprecated in C++20), [`std::atomic_load(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic) (removed in C++26), [`std::atomic_load_explicit(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_store(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_store_explicit(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_exchange(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_exchange_explicit(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_compare_exchange_weak(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_compare_exchange_strong(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_compare_exchange_weak_explicit(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic), [`std::atomic_compare_exchange_strong_explicit(std::shared_ptr)`](https://en.cppreference.com/w/cpp/memory/shared_ptr/atomic): specializes atomic operations for `std::shared_ptr` (function template)

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