Namespaces
Variants
Views
Actions

std::atomic<T>::load

From cppreference.com
< cpp‎ | atomic‎ | atomic
 
 
Concurrency support library
Threads
(C++11)
(C++20)
(C++20)
this_thread namespace
(C++11)
(C++11)
(C++11)
Mutual exclusion
(C++11)
(C++11)  
Generic lock management
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
Safe Reclamation
(C++26)
(C++26)
Hazard Pointers

Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
Memory ordering
Free functions for atomic operations
Free functions for atomic flags
 
 
T load( std::memory_order order
            = std::memory_order_seq_cst ) const noexcept;
(1) (since C++11)
T load( std::memory_order order
            = std::memory_order_seq_cst ) const volatile noexcept;
(2) (since C++11)

Atomically loads and returns the current value of the atomic variable. Memory is affected according to the value of order.

If order is one of std::memory_order_release and std::memory_order_acq_rel, the behavior is undefined.

It is deprecated if std::atomic<T>::is_always_lock_free is false and overload (2) participates in overload resolution.

(since C++20)

[edit] Parameters

order - memory order constraints to enforce

[edit] Return value

The current value of the atomic variable.

[edit] See also

loads a value from an atomic object
(public member function) [edit]
atomically obtains the value stored in an atomic object
(function template) [edit]