Thread support library

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Thread support library
Threads thread (C++11) this_thread namespace get_id (C++11) yield (C++11) sleep_for (C++11) sleep_until (C++11) Mutual exclusion mutex (C++11) timed_mutex (C++11) recursive_mutex (C++11) recursive_timed_mutex (C++11) Generic lock management lock_guard (C++11) unique_lock (C++11) defer_lock_t try_to_lock_t adopt_lock_t (C++11) (C++11) (C++11) lock (C++11) try_lock (C++11) defer_lock try_to_lock adopt_lock (C++11) (C++11) (C++11) Condition variables condition_variable (C++11) condition_variable_any (C++11) notify_all_at_thread_exit (C++11) cv_status (C++11) Futures promise (C++11) packaged_task (C++11) future (C++11) shared_future (C++11) async (C++11)

Contents 1 Threads 1.1 Functions managing the current thread 2 Mutual exclusion 2.1 Generic mutex management 2.2 Generic locking algorithms 2.3 Call once 3 Condition variables 4 Futures

[edit] Threads

Threads enable the program to execute across several processor cores.

Defined in header <thread>
thread (C++11)	manages a separate thread (class)
Functions managing the current thread
Defined in namespace this_thread
yield (C++11)	hints the implementation to reschedule execution of threads (function)
get_id (C++11)	returns the thread id of the current thread (function)
sleep_for (C++11)	stops the execution of the current thread for a specified time duration (function)
sleep_until (C++11)	stops the execution of the current thread until a specified time point (function)

[edit] Mutual exclusion

Mutual exclusion algorithms restrict access to a shared resource so that only one thread can access it at a time. This allows to avoid data races and to implement synchronization between threads.

Defined in header <mutex>
mutex (C++11)	provides basic mutual exclusion facility (class)
timed_mutex (C++11)	provides mutual exclusion facility which implements locking with a timeout (class)
recursive_mutex (C++11)	provides mutual exclusion facility which can be locked recursively by the same thread (class)
recursive_timed_mutex (C++11)	provides mutual exclusion facility which can be locked recursively by the same thread and implements locking with a timeout (class)
Generic mutex management
lock_guard (C++11)	implements strictly scope-based mutex ownership wrapper (class template)
unique_lock (C++11)	implements movable mutex ownership wrapper (class template)
defer_lock_t try_to_lock_t adopt_lock_t	tag type used to specify locking strategy (class)
defer_lock try_to_lock adopt_lock	tag constants used to specify locking strategy (constant)
Generic locking algorithms
try_lock (C++11)	locks specified mutexes/locks, returns false if at least one is unavailable (function template)
lock (C++11)	locks specified mutexes/locks, blocks if at least one is unavailable (function template)
Call once
once_flag (C++11)	helper object to ensure that call_once invokes the function only once (class)
call_once (C++11)	invokes a function only once even if called from multiple threads (function template)

[edit] Condition variables

A condition variable is a synchronization primitive which implements a list of threads that are waiting until another thread notifies one or all of the waiting threads that they may proceed, until a timeout expires, or until a spurious wakeup occurs. A condition variable is always associated with a mutex.

condition_variable (C++11)	provides a condition variable assocaited with std::unique_lock (class)
condition_variable_any (C++11)	provides a condition varibale associated with any lock type (class)
notify_all_at_thread_exit (C++11)	schedules a call to notify_all to be invoked when this thread exits (function)
cv_status (C++11)	lists the possible results of timed waits on condition variables (class)

[edit] Futures

This section is incomplete

Defined in header <future>
promise (C++11)	stores a value for asynchronous retrieval (class template)
packaged_task (C++11)	packages a function to store its return value for asynchronous retrieval (class template)
future (C++11)	waits for a value that is set asynchronously (class template)
shared_future (C++11)	waits for a value that is set asynchronously. The internal state is shared among several objects (class template)
async (C++11)	provides a facility to launch a function in a new thread and acquire its return value asynchronously (function template)