pthread_key_delete 子例程

在线编辑

用途

删除特定于线程的数据键。

库

线程库 (libpthreads.a)

语法

#include <pthread.h>

int pthread_key_delete (key)
pthread_key_t key;

描述

pthread_key_delete 子例程删除先前使用 pthread_key_create 子例程创建的特定于线程的数据键 key。 应用程序必须确保没有特定于线程的数据与密钥相关联。 未调用析构函数例程。

注: pthread.h 头文件必须是使用线程库的每个源文件的第一个包含文件。 否则，应使用 -D_THREAD_SAFE 编译标志，或使用 cc_r 编译器。 在这种情况下，会自动设置标志。

参数

项 描述
key 指定要删除的密钥。

返回值

如果成功， pthread_key_delete 函数将返回零。 否则，将返回错误号以指示错误。

错误代码

在下列情况下， pthread_key_delete 函数将失败:

项 描述
EINVAL 键值无效。

pthread_key_delete 函数不会返回错误代码 EINTR。