call_once, once_flag, ONCE_FLAG_INIT

< c‎ | thread
 
C
 
线程支持库
 
定义于头文件 <threads.h>
void call_once( once_flag* flag, void (*func)(void) );
 (1) (C11 起)
typedef /* unspecified */ once_flag
 (2) (C11 起)
#define ONCE_FLAG_INIT /* unspecified */
 (3) (C11 起)
1) 准确调用函数 func 一次，即使从多个线程调用。函数 func 的完成与先前或后继的用同一 flag 对象的对 call_once 调用同步。
2) 足以保有 call_once 所用标志的完整对象类型。
3) 展开成能用于初始化 once_flag 类型对象的值。

参数

flag - 指向用于确保只调用一次 func 的 call_once 对象的指针
func - 只执行一次的函数

返回值

（无）

注意

此函数的 POSIX 等价物是 pthread_once 。

示例

运行此代码
#include <stdio.h>
#include <threads.h>
 
void do_once(void) {
    puts("called once");
}
 
static once_flag flag = ONCE_FLAG_INIT;
int func(void* data)
{
    call_once(&flag, do_once);
}
 
int main(void)
{
    thrd_t t1, t2, t3, t4;
    thrd_create(&t1, func, NULL);
    thrd_create(&t2, func, NULL);
    thrd_create(&t3, func, NULL);
    thrd_create(&t4, func, NULL);
 
    thrd_join(t1, NULL);
    thrd_join(t2, NULL);
    thrd_join(t3, NULL);
    thrd_join(t4, NULL);
}

输出： 

called once

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.26.2.1 The call_once function (p: 378)
  • 7.26.1/3 ONCE_FLAG_INIT (p: 376)

参阅