当前位置： C语言 -- 标准库 -- <stdatomic.h> -- atomic_flag_test_and_set_explicit

atomic_flag_test_and_set_explicit函数

概要： 
#include <stdatomic.h>
_Bool atomic_flag_test_and_set_explicit(
      volatile atomic_flag *object, memory_order order);
描述：

该函数以原子方式将参数object指向的对象设置为设置状态（set state），并返回与前一个状态对应的值。该操作是个原子的读-修改-写操作。内存会受参数order值影响。当参数order值为memory_order_seq_cst时，atomic_flag_test_and_set_explicit函数与atomic_flag_test_and_set函数具有相同的语义。

参数：
volatile atomic_flag *object

指向atomic_flag类型对象的指针。

memory_order order

枚举常量，显式地指定内存顺序。

返回值：

函数返回函数调用生效前与atomic_flag类型对象的状态相对应的值。返回值true对应的是设置状态；返回值false对应的是清除状态。

范例： 
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 
/*函数atomic_flag_test_and_set_explicit范例*/

#ifdef __STDC_NO_ATOMICS__
#error "Implementation does not support atomic types."
#endif

#ifdef __STDC_NO_THREADS__
#error "Implementation does not support multi-threads."
#endif
 
#include <stdatomic.h>
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

#define THREADS 10

atomic_flag lock = ATOMIC_FLAG_INIT;
int number = 0;

/*新线程中执行的函数。*/
int func(void *arg)
{
    for(int i=0; i<10000; ++i)
    {
        /*获取lock。*/
        while(atomic_flag_test_and_set_explicit(&lock, memory_order_seq_cst))
            ;
        ++number;
        
        /*释放lock。*/
        atomic_flag_clear_explicit(&lock, memory_order_seq_cst);
    }

    thrd_exit(0);
}

int main(void)
{
    thrd_t threadId[THREADS];
    
    for(int i=0; i<THREADS; ++i)
    {
        if(thrd_create(&threadId[i], func, NULL) != thrd_success)
        {
            perror("thrd_create error");
            exit(EXIT_FAILURE);
        }
    }

    for(int i=0; i<THREADS; ++i)
        thrd_join(threadId[i], NULL);

    printf("number: %d\n", number);

    return 0;
}
输出：

number: 100000

注：使用Pelles C编译。

相关内容：
atomic_flag 表示原子标志的结构类型。
ATOMIC_FLAG_INIT 初始化atomic_flag类型对象的宏。
atomic_flag_test_and_set 将atomic_flag类型对象设置为设置状态的函数。
atomic_flag_clear_explicit 将atomic_flag类型对象设置为清除状态的函数。