call_once, once_flag, ONCE_FLAG_INIT

来自cppreference.com
< c‎ | thread
定义于头文件 <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 - 指向call_once类型对象的指针,对象被用于确保func只被调用一次
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

[编辑] 参阅

call_onceC++ 文档

[编辑] 参考

  • 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)