std::thread::detach
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Concurrency support library
(C++11)
(C++20)
(C++11)
(C++11)
(C++20)
(C++26)
(C++26)
(C++20)
(C++26)
(C++20)
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)
(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)
(C++11)
(C++11)
(C++11)
(C++11)
(C++20)(C++20)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++26)
(C++26)
(C++26)
(C++11)
(C++20)
(C++11)
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
(C++11)
(C++11)
(C++11)(deprecated in C++26)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
void detach();
(since C++11)
Separates the thread of execution from the thread object, allowing execution to continue independently. Any allocated resources will be freed once the thread exits.
After calling detach *this no longer owns any thread.
Contents
[edit] Parameters
(none)
[edit] Return value
(none)
[edit] Postconditions
joinable is false.
[edit] Exceptions
std::system_error if joinable() == false or an error occurs.
[edit] Example
Run this code
#include <chrono> #include <iostream> #include <thread> void independentThread() { std::cout << "Starting concurrent thread.\n"; std::this_thread::sleep_for (std::chrono::seconds (2)); std::cout << "Exiting concurrent thread.\n"; } void threadCaller() { std::cout << "Starting thread caller.\n"; std::thread t(independentThread); t.detach(); std::this_thread::sleep_for (std::chrono::seconds (1)); std::cout << "Exiting thread caller.\n"; } int main() { threadCaller(); std::this_thread::sleep_for (std::chrono::seconds (5)); }
Possible output:
Starting thread caller. Starting concurrent thread. Exiting thread caller. Exiting concurrent thread.
[edit] References
- C++23 standard (ISO/IEC 14882:2024):
- 33.4.3.6 Members [thread.thread.member]
- C++20 standard (ISO/IEC 14882:2020):
- 32.4.2.5 Members [thread.thread.member]
- C++17 standard (ISO/IEC 14882:2017):
- 33.3.2.5 thread members [thread.thread.member]
- C++14 standard (ISO/IEC 14882:2014):
- 30.3.1.5 thread members [thread.thread.member]
- C++11 standard (ISO/IEC 14882:2011):
- 30.3.1.5 thread members [thread.thread.member]
[edit] See also
checks whether the thread is joinable, i.e. potentially running in parallel context
(public member function) [edit]
(public member function) [edit]
C documentation for thrd_detach