PTHREAD_ATTR_SETDETACHSTATE - Linux手册页

时间:2019-08-20 18:01:01  来源:igfitidea点击:

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)。

InterfaceAttributeValue
pthread_attr_setdetachstate(),pthread_attr_getdetachstate()Thread safetyMT-Safe

遵循规范

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)。

出版信息

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