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

atomic_flag_clear_explicit函数

概要：

#include <stdatomic.h>
void atomic_flag_clear_explicit(
      volatile atomic_flag *object, memory_order order);

描述：

该函数原子地将参数object指向的对象设置为清除状态（clear state）。内存会受参数order值影响。参数order不应是memory_order_acquire或者memory_order_acq_rel。当参数order值为memory_order_seq_cst时，atomic_flag_clear_explicit函数与atomic_flag_clear函数具有相同的语义。

ISO/IEC 9899标准未指定atomic_flag_clear_explicit是宏还是具有外部链接的标识符。如果为访问实际函数而抑制宏定义，或者程序定义了与atomic_flag_clear_explicit同名的外部标识符，其行为是未定义的。

参数：

volatile atomic_flag *object

指向atomic_flag类型对象的指针。

memory_order order

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

返回值：

无。

范例：

/*函数atomic_flag_clear_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_acquire))
            thrd_yield();
        ++number;
        
        /*释放lock。*/
        atomic_flag_clear_explicit(&lock, memory_order_release);
    }

    return 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

atomic_flag	表示原子标志的结构类型。
ATOMIC_FLAG_INIT	初始化atomic_flag类型对象的宏。
atomic_flag_test_and_set_explicit	将atomic_flag类型对象设置为设置状态的函数。
atomic_flag_clear	将atomic_flag类型对象设置为清除状态的函数。