cppreference.com

Namespaces

Variants

Actions

std::thread::~thread

From cppreference.com

< cpp‎ | thread‎ | thread

Compiler support

Freestanding and hosted

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Diagnostics library

Memory management library

Metaprogramming library (C++11)

General utilities library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Strings library

Text processing library

Numerics library

Date and time library

Input/output library

Filesystem library (C++17)

Concurrency support library (C++11)

Execution control library (C++26)

Technical specifications

External libraries

Concurrency support library

(C++11)

(C++20)

hardware_destructive_interference_sizehardware_constructive_interference_size

(C++17)(C++17)

this_thread namespace

(C++11)

(C++11)

(C++11)

(C++11)

Cooperative cancellation

(C++20)

inplace_stop_token

(C++26)

never_stop_token

(C++26)

(C++20)

inplace_stop_source

(C++26)

(C++20)

inplace_stop_callback

(C++26)

stop_callback_for_t

(C++26)

stoppable_token

(C++26)

unstoppable_token

(C++26)

stoppable-source

(C++26)

stoppable-callback-for

(C++26)

Mutual exclusion

(C++11)

recursive_mutex

(C++11)

(C++17)

(C++11)

recursive_timed_mutex

(C++11)

shared_timed_mutex

(C++14)

Generic lock management

(C++11)

(C++11)

(C++17)

(C++11)

(C++14)

(C++11)

(C++11)

(C++11)

defer_locktry_to_lockadopt_lockdefer_lock_ttry_to_lock_tadopt_lock_t

(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)

Condition variables

condition_variable

(C++11)

condition_variable_any

(C++11)

notify_all_at_thread_exit

(C++11)

(C++11)

counting_semaphorebinary_semaphore

(C++20)(C++20)

Latches and Barriers

(C++20)

(C++20)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

(C++11)

future_category

(C++11)

(C++11)

Safe reclamation

(C++26)

(C++26)

rcu_default_domain

(C++26)

rcu_synchronize

(C++26)

(C++26)

(C++26)

Hazard pointers

hazard_pointer_obj_base

(C++26)

(C++26)

make_hazard_pointer

(C++26)

(C++11)

(C++20)

(C++11)

Initialization of atomic types

(C++11)(deprecated in C++20)

ATOMIC_VAR_INIT

(C++11)(deprecated in C++20)

ATOMIC_FLAG_INIT

(C++11)

Memory ordering

(C++11)

kill_dependency

(C++11)(deprecated in C++26)

atomic_thread_fence

(C++11)

atomic_signal_fence

(C++11)

Free functions for atomic operations

atomic_storeatomic_store_explicit

(C++11)(C++11)

atomic_loadatomic_load_explicit

(C++11)(C++11)

atomic_exchangeatomic_exchange_explicit

(C++11)(C++11)

atomic_compare_exchange_weakatomic_compare_exchange_weak_explicitatomic_compare_exchange_strongatomic_compare_exchange_strong_explicit

(C++11)(C++11)(C++11)(C++11)

atomic_fetch_addatomic_fetch_add_explicit

(C++11)(C++11)

atomic_fetch_subatomic_fetch_sub_explicit

(C++11)(C++11)

atomic_fetch_andatomic_fetch_and_explicit

(C++11)(C++11)

atomic_fetch_oratomic_fetch_or_explicit

(C++11)(C++11)

atomic_fetch_xoratomic_fetch_xor_explicit

(C++11)(C++11)

atomic_fetch_maxatomic_fetch_max_explicit

(C++26)(C++26)

atomic_fetch_minatomic_fetch_min_explicit

(C++26)(C++26)

atomic_is_lock_free

(C++11)

atomic_waitatomic_wait_explicit

(C++20)(C++20)

atomic_notify_one

(C++20)

atomic_notify_all

(C++20)

Free functions for atomic flags

atomic_flag_test_and_setatomic_flag_test_and_set_explicit

(C++11)(C++11)

atomic_flag_clearatomic_flag_clear_explicit

(C++11)(C++11)

atomic_flag_testatomic_flag_test_explicit

(C++20)(C++20)

atomic_flag_waitatomic_flag_wait_explicit

(C++20)(C++20)

atomic_flag_notify_one

(C++20)

atomic_flag_notify_all

(C++20)

Member functions

thread::~thread

thread::operator=

thread::joinable

thread::native_handle

thread::hardware_concurrency

Non-member functions

swap(std::thread)

(C++11)

~thread();

(since C++11)

Destroys the thread object.

If *this has an associated thread (joinable() == true), std::terminate () is called.

[edit] Notes

A thread object does not have an associated thread (and is safe to destroy) after

it was default-constructed.
it was moved from.
join() has been called.
detach() has been called.

[edit] Example

Run this code

#include <thread>
using namespace std::chrono_literals;
 
int main()
{
 auto bleah = std::thread {[]{ std::this_thread::sleep_for (13ms); }};
 
} // ~thread calls std::terminate()

Possible output:

terminate called without an active exception

[edit] See also

if the thread is joinable, then a stop is requested and the thread joins
(public member function of std::jthread) [edit]

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/thread/thread/%7Ethread&oldid=161283"