std::thread::thread
thread();
|
(1) | (since C++11) |
thread( thread&& other );
|
(2) | (since C++11) |
template< class Function, class... Args >
explicit thread( Function&& f, Args&&... args ); |
(3) | (since C++11) |
thread(const thread&) = delete;
|
(4) | (since C++11) |
Constructs new thread object.
1) Creates new thread object which does not represent a thread.
2) Move constructor. Constructs the thread object to represent the thread of execution that was represented by other. After this call other no longer represents a thread of execution.
3) Creates new std::thread object and associates it with a thread of execution. First copies all arguments args... to thread-local storage as if by the function
template <class T>
typename decay<T>::type decay_copy(T&& v) {
return std::forward<T>(v);
}
and then executes the given function f as f(copied_args...) on the new thread of execution, where copied_args are the results of calling decay_copy as defined above. Any exceptions during evaluation and copying of the arguments are thrown in the current thread, not the new thread.
4) The copy constructor is deleted; threads are not copyable. No two std::thread objects may represent the same thread of execution.
Contents |
[edit] Parameters
other | - | another thread object to construct this thread object with |
f | - | function to execute in the new thread |
args... | - | arguments to pass to the new function |
[edit] Exceptions
1-2)3) std::system_error if the thread could not be started. The exception may represent the error condition std::errc::resource_unavailable_try_again or another implementation-specific error condition.
[edit] Notes
The arguments to the thread function are copied by value. If a reference argument needs to be passed to the thread function, it has to be wrapped, e.g. with std::ref or std::cref
Any return value from the function is ignored. If the function throws an exception, std::terminate() is called. In order to pass return values or exceptions back to the calling thread, std::promise or std::async may be used.
[edit] Example
#include <iostream> #include <utility> #include <thread> #include <chrono> #include <functional> #include <atomic> void f1(int n) { for(int i=0; i<5; ++i) { std::cout << "Thread " << n << " executing\n"; std::this_thread::sleep_for(std::chrono::milliseconds(10)); } } void f2(int& n) { for(int i=0; i<5; ++i) { std::cout << "Thread 2 executing\n"; ++n; std::this_thread::sleep_for(std::chrono::milliseconds(10)); } } int main() { int n = 0; std::thread t1; // t1 is not a thread std::thread t2(f1, n+1); // pass by value std::thread t3(f2, std::ref(n)); // pass by reference std::thread t4(std::move(t3)); // t4 is now running f2(). t3 is no longer a thread t2.join(); t4.join(); std::cout << "Final value of n is " << n << '\n'; }
Output:
Thread 1 executing Thread 2 executing Thread 1 executing Thread 2 executing Thread 1 executing Thread 2 executing Thread 1 executing Thread 2 executing Thread 1 executing Thread 2 executing Final value of n is 5