当前位置: C语言 -- 标准库 -- <threads.h> -- tss_create

tss_create函数


概要:
#include <threads.h>
int tss_create(tss_t *key, tss_dtor_t dtor);

描述:

该函数创建以参数key标识的线程专属存储指针;并将参数dtor指向的析构函数与参数key指针相关联;析构函数是可选的,因此参数dtor可以是空指针。

空指针值与所有现存线程中新创建的线程专属存储指针相关联。后续创建新线程时,在新线程中所有与线程专属存储指针相关联的值都将被初始化为空指针值。

与线程专属存储相关的析构函数不会在程序终止时调用;不应从析构函数中调用tss_create函数。


参数:
tss_t *key

指向tss_t类型对象的指针。

tss_dtor_t dtor

析构函数指针,线程退出时调用。


返回值:

如果调用成功,函数将参数key指向的线程专属存储设置为唯一标识新建指针的值,并返回thrd_success;否则函数返回thrd_error,并将参数key指向的线程专属存储设置为不确定值。


范例:
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
/*函数tss_create范例*/

#ifdef __STDC_NO_THREADS__
#error "Implementation does not support multi-threads."
#endif

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <threads.h>

#define THREADS 3       //线程数。

tss_t key;

/*定义析构函数。*/
void destructor(void *arg)
{
    free(arg);
}

/*新线程中执行的函数。*/
int func(void *arg)
{
    char *ptr = (char *)arg;
    size_t size = strlen(ptr) + 1;
    tss_set(key, malloc(size));
    strcpy((char *)tss_get(key), ptr);
    printf("%s\n", (char *)tss_get(key));
    
    thrd_exit(0);
}

int main(void)
{
    thrd_t threadId[THREADS];
    char *str[THREADS] = {"Be slow to promise and quick to perform.",       \
                          "Better an empty purse than an empty head.",       \
                          "Birds of a feather flock together."};

    /*创建线程专属存储指针。*/
    if(tss_create(&key, destructor) != thrd_success)
    {
        perror("tss_create");
        exit(EXIT_FAILURE);
    }

    /*创建线程。*/
    for(int i=0; i<THREADS; ++i)
    {
        if(thrd_create(&threadId[i], func, str[i]) != thrd_success)
        {
            perror("thrd_create");
            exit(EXIT_FAILURE);
        }
    }

    /*连接线程。*/
    for(int i=0; i<THREADS; ++i)
        thrd_join(threadId[i], NULL);

    /*释放线程专属存储所用资源。*/
    tss_delete(key);
    
    return 0;
}


输出:

Be slow to promise and quick to perform.

Better an empty purse than an empty head.

Birds of a feather flock together.

注:使用Pelles C编译。


相关内容:
tss_set 设置线程专属存储的函数。
tss_get 获取线程专属存储的函数。
tss_delete 释放线程专属存储所用资源的函数。