Linux程序员手册 第3部分
更新日期： 2020-06-09

名称

pthread_attr_setdetachstate，pthread_attr_getdetachstate-在线程属性对象中设置/获取分离状态属性

语法

#include <pthread.h>

int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);
int pthread_attr_getdetachstate(const pthread_attr_t *attr, int *detachstate);

Compile and link with -pthread.

说明

pthread_attr_setdetachstate()函数将attr引用的线程属性对象的分离状态属性设置为detachstate中指定的值。分离状态属性确定使用线程属性对象attr创建的线程将以可连接状态还是分离状态创建。

可以在detachstate中指定以下值：

PTHREAD_CREATE_DETACHED

使用attr创建的线程将以分离状态创建。

PTHREAD_CREATE_JOINABLE

使用attr创建的线程将以可连接状态创建。

在新初始化的线程属性对象中，分离状态属性的默认设置为PTHREAD_CREATE_JOINABLE。

pthread_attr_getdetachstate()返回分离状态指向的缓冲区中线程属性对象attr的分离状态属性。

返回值

成功时，这些函数返回0；否则，返回0。错误时，它们返回非零错误号。

错误说明

pthread_attr_setdetachstate()可能因以下错误而失败：

EINVAL

在detachstate中指定了无效的值。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

POSIX.1-2001，POSIX.1-2008。

备注

有关分离和可连接线程的更多详细信息，请参见pthread_create(3)。

以可连接状态创建的线程最终应使用pthread_join(3)进行连接或使用pthread_detach(3)进行分离；请参见pthread_create(3)。

在以后对pthread_detach(3)或pthread_join(3)的调用中，指定在分离状态下创建的线程的线程ID是错误的。

示例

请参见pthread_attr_init(3)。

另外参见

pthread_attr_init(3)，pthread_create(3)，pthread_detach(3)，pthread_join(3)，pthreads(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。