annotate foosdk/sdk/pfc/once.h @ 1:20d02a178406 default tip

*: check in everything else yay
author Paper <paper@tflc.us>
date Mon, 05 Jan 2026 02:15:46 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
1 #pragma once
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
2
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
3 #include <functional>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
4 #include "event.h"
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
5 #include <memory>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
6 #include "lockless.h"
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
7
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
8 #ifdef __ANDROID__
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
9 #define PFC_CUSTOM_ONCE_FLAG 1
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
10 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
11
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
12 #ifndef PFC_CUSTOM_ONCE_FLAG
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
13 #define PFC_CUSTOM_ONCE_FLAG 0
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
14 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
15
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
16 #if ! PFC_CUSTOM_ONCE_FLAG
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
17 #include <mutex>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
18 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
19
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
20 namespace pfc {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
21 #if PFC_CUSTOM_ONCE_FLAG
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
22 struct once_flag {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
23 bool inProgress = false, done = false;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
24 std::shared_ptr<::pfc::event> waitFor;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
25 };
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
26
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
27 void call_once( once_flag &, std::function<void () > );
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
28 #else
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
29 using std::once_flag;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
30 using std::call_once;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
31 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
32
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
33 //! Minimalist class to call some function only once. \n
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
34 //! Presumes low probability of concurrent run() calls actually happening, \n
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
35 //! but frequent calls once already initialized, hence only using basic volatile bool check. \n
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
36 //! If using a modern compiler you might want to use std::call_once instead. \n
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
37 //! The called function is not expected to throw exceptions.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
38 struct once_flag_lite {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
39 threadSafeInt::val_t guard = 0;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
40 volatile bool done = false;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
41 };
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
42
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
43 void call_once( once_flag_lite &, std::function<void () > );
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
44
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
45 class runOnceLock {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
46 public:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
47 void run(std::function<void()> f) {call_once(m_flag, f);}
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
48 private:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
49 once_flag_lite m_flag;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
50 };
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
51 }