NAME
thrd_detach —
detach a thread
SYNOPSIS
#include
<threads.h>
int thrd_detach(thrd_t thr);
DESCRIPTION
[CX] The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2024 defers to the ISO C standard.
The thrd_detach () function shall change
the thread thr from joinable to detached, indicating to
the implementation that any resources allocated to the thread can be
reclaimed when that thread terminates. The application shall ensure that the
thread identified by thr has not been previously detached
or joined with another thread.
[CX] The thrd_detach ()
function shall not be affected if the calling thread executes a signal
handler during the call.
RETURN VALUE
The thrd_detach () function shall return
thrd_success on success or
thrd_error if the request could not be honored.
ERRORS
No errors are defined.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
The thrd_detach () function is not
affected by signal handlers for the reasons stated in XRAT
B.2.3
Error Numbers.
FUTURE DIRECTIONS
None.
SEE ALSO
pthread_detach(3), thrd_create(3), thrd_join(3)
XBD <threads.h>
CHANGE HISTORY
First released in Issue 8. Included for alignment with the ISO/IEC 9899:2018 standard.