std::atomic<T>::load

From cppreference.com
< cpp‎ | atomic‎ | atomic
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
(C++11)
(C++11)
(C++17)
Generic lock management
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(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)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Safe Reclamation
(C++26)
(C++26)
(C++26)
Hazard Pointers
(C++26)
Atomic types
(C++11)
(C++20)
(C++11)
Initialization of atomic types
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
Memory ordering
(C++11)
(C++11)
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

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

(since C++20)

Parameters

order - memory order constraints to enforce

Return value

The current value of the atomic variable.

See also

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