◆ FIFTYONE_DEGREES_INTERLOCK_DEC
| #define FIFTYONE_DEGREES_INTERLOCK_DEC | ( | v | ) | (__atomic_add_fetch(v, -1, __ATOMIC_SEQ_CST)) |
Decrements the value and returns the final value.
- Parameters
-
- v - the value to decrement
- Returns
- value after decrementing
◆ FIFTYONE_DEGREES_INTERLOCK_EXCHANGE
#define FIFTYONE_DEGREES_INTERLOCK_EXCHANGE ( d, e, c ) __sync_val_compare_and_swap(&d,c,e) Replaces the destination value with the exchange value, only if the destination value matched the comparand.
Returns the value of d before the swap.
- Parameters
-
- d - the destination to swap
- e - the exchange value
- c - the comparand
◆ FIFTYONE_DEGREES_INTERLOCK_EXCHANGE_64
#define FIFTYONE_DEGREES_INTERLOCK_EXCHANGE_64 ( d, e, c ) FIFTYONE_DEGREES_INTERLOCK_EXCHANGE(d,e,c) 64 bit compare and swap.
Replaces the destination value with the exchange value, only if the destination value matched the comparand. Returns the value of d before the swap.
- Parameters
-
- d - the destination to swap
- e - the exchange value
- c - the comparand
◆ FIFTYONE_DEGREES_INTERLOCK_EXCHANGE_DW
#define FIFTYONE_DEGREES_INTERLOCK_EXCHANGE_DW ( d, e, c ) Value:(__atomic_compare_exchange( \false, \__ATOMIC_SEQ_CST, \__ATOMIC_SEQ_CST))Double width (64 or 128 depending on the architecture) compare and exchange.Definition: threading.h:427◆ FIFTYONE_DEGREES_INTERLOCK_EXCHANGE_PTR
#define FIFTYONE_DEGREES_INTERLOCK_EXCHANGE_PTR ( d, e, c ) FIFTYONE_DEGREES_INTERLOCK_EXCHANGE(d,e,c) Replaces the destination pointer with the exchange pointer, only if the destination pointer matched the comparand.
Returns the value of d before the swap.
- Parameters
-
- d - the destination to swap
- e - the exchange value
- c - the comparand
◆ FIFTYONE_DEGREES_INTERLOCK_INC
#define FIFTYONE_DEGREES_INTERLOCK_INC ( v ) (__atomic_add_fetch(v, 1, __ATOMIC_SEQ_CST)) Increments the value and returns the final value.
- Parameters
-
- v - the value to decrement
- Returns
- value after incrementing
◆ FIFTYONE_DEGREES_MUTEX_CLOSE
#define FIFTYONE_DEGREES_MUTEX_CLOSE ( m ) fiftyoneDegreesMutexClose(&m) Frees the mutex at the pointer provided.
- Parameters
-
- m - mutex to close
◆ FIFTYONE_DEGREES_MUTEX_CREATE
#define FIFTYONE_DEGREES_MUTEX_CREATE ( m ) fiftyoneDegreesMutexCreate(&m) Creates a new mutex at the pointer provided.
- Parameters
-
- m - mutex to create
◆ FIFTYONE_DEGREES_MUTEX_LOCK
#define FIFTYONE_DEGREES_MUTEX_LOCK ( m ) fiftyoneDegreesMutexLock(m) Locks the mutex at the pointer provided.
- Parameters
-
- m - mutex to lock
◆ FIFTYONE_DEGREES_MUTEX_UNLOCK
#define FIFTYONE_DEGREES_MUTEX_UNLOCK ( m ) fiftyoneDegreesMutexUnlock(m) Unlocks the mutex at the pointer provided.
- Parameters
-
- m - mutex to unlock
◆ FIFTYONE_DEGREES_MUTEX_VALID
#define FIFTYONE_DEGREES_MUTEX_VALID ( m ) fiftyoneDegreesMutexValid(m) Returns true if the mutex is valid.
- Parameters
-
- m - mutex to check
- Returns
- true if valid
◆ FIFTYONE_DEGREES_SIGNAL_CLOSE
#define FIFTYONE_DEGREES_SIGNAL_CLOSE ( s ) fiftyoneDegreesSignalClose(s) Frees the handle provided to the macro.
- Parameters
-
- s - signal to close
◆ FIFTYONE_DEGREES_SIGNAL_CREATE
#define FIFTYONE_DEGREES_SIGNAL_CREATE ( s ) s = fiftyoneDegreesSignalCreate() Creates a new signal that can be used to wait for other operations to complete before continuing.
- Parameters
-
- s - signal to create
◆ FIFTYONE_DEGREES_SIGNAL_SET
#define FIFTYONE_DEGREES_SIGNAL_SET ( s ) fiftyoneDegreesSignalSet(s) Signals a thread waiting for the signal to proceed.
- Parameters
-
- s - signal to set
◆ FIFTYONE_DEGREES_SIGNAL_WAIT
#define FIFTYONE_DEGREES_SIGNAL_WAIT ( s ) fiftyoneDegreesSignalWait(s) Waits for the signal to become set by another thread.
- Parameters
-
- s - signal to wait on
◆ FIFTYONE_DEGREES_THREAD_CLOSE
#define FIFTYONE_DEGREES_THREAD_CLOSE ( t ) Closes the thread passed to the macro.
- Parameters
-
- t - thread to close
◆ FIFTYONE_DEGREES_THREAD_CREATE
#define FIFTYONE_DEGREES_THREAD_CREATE ( t, m, s ) pthread_create(&t, NULL, m, s) Creates a new thread with the following parameters:
- Parameters
-
- t - pointer to FIFTYONE_DEGREES_THREAD memory
- m - the method to call when the thread runs
- s - pointer to the state data to pass to the method
- Returns
- new thread
◆ FIFTYONE_DEGREES_THREAD_JOIN
#define FIFTYONE_DEGREES_THREAD_JOIN ( t ) pthread_join(t, NULL) Creates a new thread with the following parameters:
- Parameters
-
- t - pointer to FIFTYONE_DEGREES_THREAD memory
- m - the method to call when the thread runs
- s - pointer to the state data to pass to the method
- Returns
- new thread
◆ FIFTYONE_DEGREES_THREAD_JOIN
#define FIFTYONE_DEGREES_THREAD_JOIN ( t ) pthread_join(t, NULL) Joins the thread provided to the current thread waiting indefinitely for the operation to complete.
- Parameters
-
- t - pointer to a previously created thread
Typedef Documentation
◆ fiftyoneDegreesMutex
typedef pthread_mutex_t fiftyoneDegreesMutex MUTEX AND THREADING MACROS.
Mutex used to synchronise access to data structures that could be used in parallel in a multi threaded environment.
Function Documentation
◆ fiftyoneDegreesMutexClose()
void fiftyoneDegreesMutexClose ( fiftyoneDegreesMutex * mutex ) Closes the mutex passed to the method.
- Parameters
-
- mutex - to be closed.
◆ fiftyoneDegreesMutexCreate()
void fiftyoneDegreesMutexCreate ( fiftyoneDegreesMutex * mutex ) Initialises the mutex passed to the method.
- Parameters
-
- mutex - to be initialised.
◆ fiftyoneDegreesMutexLock()
void fiftyoneDegreesMutexLock ( fiftyoneDegreesMutex * mutex ) Locks the mutex passed to the method.
- Parameters
-
- mutex - to be locked.
◆ fiftyoneDegreesMutexUnlock()
void fiftyoneDegreesMutexUnlock ( fiftyoneDegreesMutex * mutex ) Unlocks the mutex passed to the method.
- Parameters
-
- mutex - to be unlocked.
◆ fiftyoneDegreesSignalClose()
void fiftyoneDegreesSignalClose ( fiftyoneDegreesSignal * signal ) Closes the signal ensuring there is a lock on the signal before destroying the signal.
This means that no other process can be waiting on the signal before it is destroyed. The destroyed field of the signal structure is set to true after the condition is destroyed. All methods that could subsequently try and get a lock on the signal MUST check the destroyed field before trying to get the lock.
- Parameters
-
- signal - to be closed.
◆ fiftyoneDegreesSignalCreate()
fiftyoneDegreesSignal* fiftyoneDegreesSignalCreate ( ) Initialises the signal pointer by setting the condition first followed by the mutex if the condition was set correctly.
Destroyed is set to false to indicate to the other methods that the signal is still valid. The memory used by the signal should be part of another structure and will be released when that structure is released. If there is a problem creating the mutex the condition is also released.
- Returns
- new signal
◆ fiftyoneDegreesSignalSet()
void fiftyoneDegreesSignalSet ( fiftyoneDegreesSignal * signal ) If the signal has not been destroyed then sends a signal to a waiting thread that the signal has been set and one can continue.
This possible because the condition will auto reset only enabling a signal thread to continue even if multi threads are waiting.
- Parameters
-
- signal - to be set.
◆ fiftyoneDegreesSignalWait()
void fiftyoneDegreesSignalWait ( fiftyoneDegreesSignal * signal ) Wait for a signal to be set.
Only waits for the signal if the signal has not been destroyed. Locks the mutex before the signal is waited for. This ensures only one thread can be waiting on the signal at any one time.
- Parameters
-
- signal - pointer to the signal used to wait on.
◆ fiftyoneDegreesThreadingGetIsThreadSafe()
bool fiftyoneDegreesThreadingGetIsThreadSafe ( ) Determines if the methods that should be thread safe have been compiled so they are thread safe.
In single threaded operation compiling without threading using the
FIFTYONE_DEGREES_NO_THREADINGdirective results in performance improvements.- Returns
- true if the library is thread safe, otherwise false.
- Examples
- Hash/ReloadFromFile.cpp, and Hash/ReloadFromMemory.cpp.