489 lines
20 KiB
C++
489 lines
20 KiB
C++
// =================================================================================================
|
|
// [$CFGM] Config macros | | Compile time customisation of library
|
|
// =================================================================================================
|
|
// #define DQN_IMPLEMENTATION
|
|
// Define this in one and only one C++ file to enable the implementation
|
|
// code of the header file
|
|
//
|
|
// #define DQN_NO_ASSERT
|
|
// Turn all assertion macros to no-ops
|
|
//
|
|
// #define DQN_NO_CHECK_BREAK
|
|
// Disable debug break when a check macro's expression fails. Instead only
|
|
// the error will be logged.
|
|
//
|
|
// #define DQN_NO_WIN32_MINIMAL_HEADER
|
|
// Define this to stop this library from defining a minimal subset of Win32
|
|
// prototypes and definitions in this file. Useful for stopping redefinition
|
|
// of symbols if another library includes "Windows.h"
|
|
//
|
|
// #define DQN_STATIC_API
|
|
// Apply static to all function definitions and disable external linkage to
|
|
// other translation units.
|
|
//
|
|
// #define DQN_STB_SPRINTF_HEADER_ONLY
|
|
// Define this to stop this library from defining
|
|
// STB_SPRINTF_IMPLEMENTATION. Useful if another library uses and includes
|
|
// "stb_sprintf.h"
|
|
//
|
|
// #define DQN_MEMSET_BYTE 0
|
|
// Change the byte that DQN_MEMSET will clear memory with. By default this
|
|
// is set to 0. Some of this library API accepts are clear memory parameter
|
|
// to scrub memory after certain operations.
|
|
//
|
|
// #define DQN_LEAK_TRACING
|
|
// When defined to some allocating calls in the library will automatically
|
|
// get passed in the file name, function name, line number and an optional
|
|
// leak_msg.
|
|
|
|
#if defined(DQN_LEAK_TRACING)
|
|
#error Leak tracing not supported because we enter an infinite leak tracing loop tracing our own allocations made to tracks leaks in the internal leak table.
|
|
#endif
|
|
|
|
//
|
|
// #define DQN_DEBUG_THREAD_CONTEXT
|
|
// Define this macro to record allocation stats for arenas used in the
|
|
// thread context. The thread context arena stats can be printed by using
|
|
// Dqn_Library_DumpThreadContextArenaStat.
|
|
//
|
|
// =================================================================================================
|
|
// [$CMAC] Compiler macros | | Macros for the compiler
|
|
// =================================================================================================
|
|
// NOTE: Warning! Order is important here, clang-cl on Windows defines _MSC_VER
|
|
#if defined(_MSC_VER)
|
|
#if defined(__clang__)
|
|
#define DQN_COMPILER_W32_CLANG
|
|
#else
|
|
#define DQN_COMPILER_W32_MSVC
|
|
#endif
|
|
#elif defined(__clang__)
|
|
#define DQN_COMPILER_CLANG
|
|
#elif defined(__GNUC__)
|
|
#define DQN_COMPILER_GCC
|
|
#endif
|
|
|
|
#if defined(_WIN32)
|
|
#define DQN_OS_WIN32
|
|
#elif defined(__aarch64__) || defined(_M_ARM64)
|
|
#define DQN_OS_ARM64
|
|
#else
|
|
#define DQN_OS_UNIX
|
|
#endif
|
|
|
|
#if defined(DQN_COMPILER_W32_MSVC) || defined(DQN_COMPILER_W32_CLANG)
|
|
#if defined(_CRT_SECURE_NO_WARNINGS)
|
|
#define DQN_CRT_SECURE_NO_WARNINGS_PREVIOUSLY_DEFINED
|
|
#else
|
|
#define _CRT_SECURE_NO_WARNINGS
|
|
#endif
|
|
#endif
|
|
|
|
// =================================================================================================
|
|
// [$MACR] Macros | | Define macros used in the library
|
|
// =================================================================================================
|
|
#define DQN_FOR_UINDEX(index, size) for (Dqn_usize index = 0; index < size; index++)
|
|
#define DQN_FOR_IINDEX(index, size) for (Dqn_isize index = 0; index < size; index++)
|
|
|
|
#define Dqn_PowerOfTwoAlign(value, power_of_two) (((value) + ((power_of_two) - 1)) & ~((power_of_two) - 1))
|
|
#define Dqn_IsPowerOfTwo(value) (((value) & (value - 1)) == 0)
|
|
#define Dqn_IsPowerOfTwoAligned(value, power_of_two) (((value) & (power_of_two - 1)) == 0)
|
|
|
|
// NOTE: Alloc Macros ==============================================================================
|
|
#if !defined(DQN_ALLOC)
|
|
#define DQN_ALLOC(size) Dqn_VMem_Reserve(size, Dqn_VMemCommit_Yes, Dqn_VMemPage_ReadWrite)
|
|
#endif
|
|
|
|
#if !defined(DQN_DEALLOC)
|
|
#define DQN_DEALLOC(ptr, size) Dqn_VMem_Release(ptr, size)
|
|
#endif
|
|
|
|
// NOTE: String.h Dependnecies =====================================================================
|
|
#if !defined(DQN_MEMCPY) || !defined(DQN_MEMSET) || !defined(DQN_MEMCMP) || !defined(DQN_MEMMOVE)
|
|
#include <string.h>
|
|
#if !defined(DQN_MEMCPY)
|
|
#define DQN_MEMCPY(dest, src, count) memcpy(dest, src, count)
|
|
#endif
|
|
#if !defined(DQN_MEMSET)
|
|
#define DQN_MEMSET(dest, value, count) memset(dest, value, count)
|
|
#endif
|
|
#if !defined(DQN_MEMCMP)
|
|
#define DQN_MEMCMP(ptr1, ptr2, num) memcmp(ptr1, ptr2, num)
|
|
#endif
|
|
#if !defined(DQN_MEMMOVE)
|
|
#define DQN_MEMMOVE(dest, src, num) memmove(dest, src, num)
|
|
#endif
|
|
#endif
|
|
|
|
// NOTE: Math.h Dependnecies =======================================================================
|
|
#if !defined(DQN_SQRTF) || !defined(DQN_SINF) || !defined(DQN_COSF) || !defined(DQN_TANF)
|
|
#include <math.h>
|
|
#define DQN_SQRTF(val) sqrtf(val)
|
|
#if !defined(DQN_SINF)
|
|
#define DQN_SINF(val) sinf(val)
|
|
#endif
|
|
#if !defined(DQN_COSF)
|
|
#define DQN_COSF(val) cosf(val)
|
|
#endif
|
|
#if !defined(DQN_TANF)
|
|
#define DQN_TANF(val) tanf(val)
|
|
#endif
|
|
#endif
|
|
|
|
// NOTE: Math Macros ===============================================================================
|
|
#define DQN_PI 3.14159265359f
|
|
|
|
#define DQN_DEGREE_TO_RADIAN(degrees) ((degrees) * (DQN_PI / 180.0f))
|
|
#define DQN_RADIAN_TO_DEGREE(radians) ((radians) * (180.f * DQN_PI))
|
|
|
|
#define DQN_ABS(val) (((val) < 0) ? (-(val)) : (val))
|
|
#define DQN_MAX(a, b) ((a > b) ? (a) : (b))
|
|
#define DQN_MIN(a, b) ((a < b) ? (a) : (b))
|
|
#define DQN_CLAMP(val, lo, hi) DQN_MAX(DQN_MIN(val, hi), lo)
|
|
#define DQN_SQUARED(val) ((val) * (val))
|
|
|
|
// NOTE: Function/Variable Annotations =============================================================
|
|
#if defined(DQN_STATIC_API)
|
|
#define DQN_API static
|
|
#else
|
|
#define DQN_API
|
|
#endif
|
|
|
|
#define DQN_LOCAL_PERSIST static
|
|
#define DQN_FILE_SCOPE static
|
|
#define DQN_CAST(val) (val)
|
|
|
|
#if defined(DQN_COMPILER_W32_MSVC) || defined(DQN_COMPILER_W32_CLANG)
|
|
#define DQN_FORCE_INLINE __forceinline
|
|
#else
|
|
#define DQN_FORCE_INLINE inline __attribute__((always_inline))
|
|
#endif
|
|
|
|
// NOTE: Preprocessor Token Tricks =================================================================
|
|
#define DQN_TOKEN_COMBINE2(x, y) x ## y
|
|
#define DQN_TOKEN_COMBINE(x, y) DQN_TOKEN_COMBINE2(x, y)
|
|
#define DQN_UNIQUE_NAME(prefix) DQN_TOKEN_COMBINE(prefix, __LINE__)
|
|
|
|
#define DQN_SWAP(a, b) \
|
|
do \
|
|
{ \
|
|
auto temp = a; \
|
|
a = b; \
|
|
b = temp; \
|
|
} while (0)
|
|
|
|
// NOTE: Size Macros ===============================================================================
|
|
#define DQN_ISIZEOF(val) DQN_CAST(ptrdiff_t)sizeof(val)
|
|
#define DQN_ARRAY_UCOUNT(array) (sizeof(array)/(sizeof((array)[0])))
|
|
#define DQN_ARRAY_ICOUNT(array) (Dqn_isize)DQN_ARRAY_UCOUNT(array)
|
|
#define DQN_CHAR_COUNT(string) (sizeof(string) - 1)
|
|
|
|
// NOTE: SI Byte Macros ============================================================================
|
|
#define DQN_BYTES(val) (val)
|
|
#define DQN_KILOBYTES(val) (1024ULL * DQN_BYTES(val))
|
|
#define DQN_MEGABYTES(val) (1024ULL * DQN_KILOBYTES(val))
|
|
#define DQN_GIGABYTES(val) (1024ULL * DQN_MEGABYTES(val))
|
|
|
|
// NOTE: Time Macros ===============================================================================
|
|
#define DQN_SECONDS_TO_MS(val) ((val) * 1000.0f)
|
|
#define DQN_MINS_TO_S(val) ((val) * 60ULL)
|
|
#define DQN_HOURS_TO_S(val) (DQN_MINS_TO_S(val) * 60ULL)
|
|
#define DQN_DAYS_TO_S(val) (DQN_HOURS_TO_S(val) * 24ULL)
|
|
#define DQN_YEARS_TO_S(val) (DQN_DAYS_TO_S(val) * 365ULL)
|
|
|
|
// NOTE: Debug Macros ==============================================================================
|
|
#if !defined(DQN_DEBUG_BREAK)
|
|
#if defined(NDEBUG)
|
|
#define DQN_DEBUG_BREAK
|
|
#else
|
|
#if defined(DQN_COMPILER_W32_MSVC) || defined(DQN_COMPILER_W32_CLANG)
|
|
#define DQN_DEBUG_BREAK __debugbreak()
|
|
#elif defined(DQN_COMPILER_CLANG) || defined(DQN_COMPILER_GCC)
|
|
#include <signal.h>
|
|
#define DQN_DEBUG_BREAK raise(SIGTRAP)
|
|
#elif
|
|
#error "Unhandled compiler"
|
|
#endif
|
|
#endif
|
|
#endif
|
|
|
|
#if !defined(DQN_MEMSET_BYTE)
|
|
#define DQN_MEMSET_BYTE 0
|
|
#endif
|
|
|
|
// NOTE: Assert Macros =============================================================================
|
|
#define DQN_HARD_ASSERT(expr) DQN_HARD_ASSERTF(expr, "")
|
|
#define DQN_HARD_ASSERTF(expr, fmt, ...) \
|
|
if (!(expr)) { \
|
|
Dqn_Log_ErrorF("Hard assert triggered " #expr ". " fmt, ##__VA_ARGS__); \
|
|
DQN_DEBUG_BREAK; \
|
|
}
|
|
|
|
#if defined(DQN_NO_ASSERT)
|
|
#define DQN_ASSERTF(...)
|
|
#define DQN_ASSERT(...)
|
|
#else
|
|
#define DQN_ASSERT(expr) DQN_ASSERTF(expr, "")
|
|
#define DQN_ASSERTF(expr, fmt, ...) \
|
|
if (!(expr)) { \
|
|
Dqn_Log_ErrorF("Assert triggered " #expr ". " fmt, ##__VA_ARGS__); \
|
|
DQN_DEBUG_BREAK; \
|
|
}
|
|
#endif
|
|
|
|
#define DQN_CHECK(expr) DQN_CHECKF(expr, "")
|
|
#if defined(DQN_NO_CHECK_BREAK)
|
|
#define DQN_CHECKF(expr, fmt, ...) \
|
|
((expr) ? true : (Dqn_Log_TypeFCallSite(Dqn_LogType_Warning, DQN_CALL_SITE, fmt, ## __VA_ARGS__), false))
|
|
#else
|
|
#define DQN_CHECKF(expr, fmt, ...) \
|
|
((expr) ? true : (Dqn_Log_TypeFCallSite(Dqn_LogType_Error, DQN_CALL_SITE, fmt, ## __VA_ARGS__), DQN_DEBUG_BREAK, false))
|
|
#endif
|
|
|
|
#if 0
|
|
DQN_API bool DQN_CHECKF_(bool assertion_expr, Dqn_CallSite call_site, char const *fmt, ...)
|
|
{
|
|
bool result = assertion_expr;
|
|
if (!result) {
|
|
va_list args;
|
|
va_start(args, fmt);
|
|
Dqn_Log_TypeFVCallSite(Dqn_LogType_Error, call_site, fmt, args);
|
|
va_end(args);
|
|
DQN_DEBUG_BREAK;
|
|
}
|
|
return result;
|
|
}
|
|
#endif
|
|
|
|
#if defined(__cplusplus)
|
|
#define DQN_ZERO_INIT {}
|
|
#else
|
|
#define DQN_ZERO_INIT {0}
|
|
#endif
|
|
|
|
#define DQN_INVALID_CODE_PATHF(fmt, ...) DQN_ASSERTF(0, fmt, ##__VA_ARGS__)
|
|
#define DQN_INVALID_CODE_PATH DQN_INVALID_CODE_PATHF("Invalid code path triggered")
|
|
|
|
// NOTE: Defer Macro ===============================================================================
|
|
#if 0
|
|
#include <stdio.h>
|
|
int main()
|
|
{
|
|
DQN_DEFER { printf("Three ..\n"); };
|
|
printf("One ..\n");
|
|
printf("Two ..\n");
|
|
|
|
// One ..
|
|
// Two ..
|
|
// Three ..
|
|
|
|
return 0;
|
|
}
|
|
#endif
|
|
|
|
template <typename Procedure>
|
|
struct Dqn_Defer
|
|
{
|
|
Procedure proc;
|
|
Dqn_Defer(Procedure p) : proc(p) {}
|
|
~Dqn_Defer() { proc(); }
|
|
};
|
|
|
|
struct Dqn_DeferHelper
|
|
{
|
|
template <typename Lambda>
|
|
Dqn_Defer<Lambda> operator+(Lambda lambda) { return Dqn_Defer<Lambda>(lambda); };
|
|
};
|
|
|
|
#define DQN_DEFER const auto DQN_UNIQUE_NAME(defer_lambda_) = Dqn_DeferHelper() + [&]()
|
|
|
|
#define DQN_DEFER_LOOP(begin, end) \
|
|
for (bool DQN_UNIQUE_NAME(once) = (begin, true); \
|
|
DQN_UNIQUE_NAME(once); \
|
|
end, DQN_UNIQUE_NAME(once) = false)
|
|
|
|
// =================================================================================================
|
|
// [$TYPE] Typedefs | | Typedefs used in the library
|
|
// =================================================================================================
|
|
typedef intptr_t Dqn_isize;
|
|
typedef uintptr_t Dqn_usize;
|
|
typedef intptr_t Dqn_isize;
|
|
typedef float Dqn_f32;
|
|
typedef double Dqn_f64;
|
|
typedef unsigned int Dqn_uint;
|
|
typedef int32_t Dqn_b32;
|
|
|
|
#define DQN_USIZE_MAX UINTPTR_MAX
|
|
#define DQN_ISIZE_MAX INTPTR_MAX
|
|
#define DQN_ISIZE_MIN INTPTR_MIN
|
|
|
|
// =================================================================================================
|
|
// [$GSTR] Global Structs | | Forward declare useful structs
|
|
// =================================================================================================
|
|
struct Dqn_String8 ///< Pointer and length style UTF8 strings
|
|
{
|
|
char *data; ///< The UTF8 bytes of the string
|
|
Dqn_usize size; ///< The number of bytes in the string
|
|
|
|
#if defined(__cplusplus)
|
|
char const *begin() const { return data; } ///< Const begin iterator for range-for loops
|
|
char const *end () const { return data + size; } ///< Const end iterator for range-for loops
|
|
char *begin() { return data; } ///< Begin iterator for range-for loops
|
|
char *end () { return data + size; } ///< End iterator for range-for loops
|
|
#endif
|
|
};
|
|
|
|
// =================================================================================================
|
|
// [$INTR] Intrinsics | | Atomics, cpuid, ticket mutex
|
|
// =================================================================================================
|
|
typedef enum Dqn_ZeroMem {
|
|
Dqn_ZeroMem_No, ///< Memory can be handed out without zero-ing it out
|
|
Dqn_ZeroMem_Yes, ///< Memory should be zero-ed out before giving to the callee
|
|
} Dqn_ZeroMem;
|
|
|
|
// NOTE: Dqn_Atomic_Add/Exchange return the previous value store in the target
|
|
#if defined(DQN_COMPILER_W32_MSVC) || defined(DQN_COMPILER_W32_CLANG)
|
|
#include <intrin.h>
|
|
#define Dqn_Atomic_CompareExchange64(dest, desired_val, prev_val) _InterlockedCompareExchange64((__int64 volatile *)dest, desired_val, prev_val)
|
|
#define Dqn_Atomic_CompareExchange32(dest, desired_val, prev_val) _InterlockedCompareExchange((long volatile *)dest, desired_val, prev_val)
|
|
#define Dqn_Atomic_AddU32(target, value) _InterlockedExchangeAdd((long volatile *)target, value)
|
|
#define Dqn_Atomic_AddU64(target, value) _InterlockedExchangeAdd64((__int64 volatile *)target, value)
|
|
#define Dqn_Atomic_SubU32(target, value) Dqn_Atomic_AddU32(DQN_CAST(long volatile *)target, (long)-value)
|
|
#define Dqn_Atomic_SubU64(target, value) Dqn_Atomic_AddU64(target, (uint64_t)-value)
|
|
#define Dqn_CPUClockCycle() __rdtsc()
|
|
#define Dqn_CompilerReadBarrierAndCPUReadFence _ReadBarrier(); _mm_lfence()
|
|
#define Dqn_CompilerWriteBarrierAndCPUWriteFence _WriteBarrier(); _mm_sfence()
|
|
#elif defined(DQN_COMPILER_GCC) || defined(DQN_COMPILER_CLANG)
|
|
#if defined(__ANDROID__)
|
|
|
|
#else
|
|
#include <x86intrin.h>
|
|
#endif
|
|
|
|
#define Dqn_Atomic_AddU32(target, value) __atomic_fetch_add(target, value, __ATOMIC_ACQ_REL)
|
|
#define Dqn_Atomic_AddU64(target, value) __atomic_fetch_add(target, value, __ATOMIC_ACQ_REL)
|
|
#define Dqn_Atomic_SubU32(target, value) __atomic_fetch_sub(target, value, __ATOMIC_ACQ_REL)
|
|
#define Dqn_Atomic_SubU64(target, value) __atomic_fetch_sub(target, value, __ATOMIC_ACQ_REL)
|
|
#if defined(DQN_COMPILER_GCC)
|
|
#define Dqn_CPUClockCycle() __rdtsc()
|
|
#else
|
|
#define Dqn_CPUClockCycle() __builtin_readcyclecounter()
|
|
#endif
|
|
#define Dqn_CompilerReadBarrierAndCPUReadFence asm volatile("lfence" ::: "memory")
|
|
#define Dqn_CompilerWriteBarrierAndCPUWriteFence asm volatile("sfence" ::: "memory")
|
|
#else
|
|
#error "Compiler not supported"
|
|
#endif
|
|
|
|
/// Atomically set the value into the target using an atomic compare and swap.
|
|
/// @param[in,out] target The target pointer to set atomically
|
|
/// @param[in] value The value to set atomically into the target
|
|
/// @return The value that was last stored in the target
|
|
DQN_FORCE_INLINE uint64_t Dqn_Atomic_SetValue64(uint64_t volatile *target, uint64_t value)
|
|
{
|
|
#if defined(DQN_COMPILER_W32_MSVC) || defined(DQN_COMPILER_W32_CLANG)
|
|
__int64 result;
|
|
do {
|
|
result = *target;
|
|
} while (Dqn_Atomic_CompareExchange64(target, value, result) != result);
|
|
return DQN_CAST(uint64_t)result;
|
|
#elif defined(DQN_COMPILER_GCC) || defined(DQN_COMPILER_CLANG)
|
|
uint64_t result = __sync_lock_test_and_set(target, value);
|
|
return result;
|
|
#else
|
|
#error Unsupported compiler
|
|
#endif
|
|
}
|
|
|
|
/// Atomically set the value into the target using an atomic compare and swap.
|
|
/// @param[in,out] target The target pointer to set atomically
|
|
/// @param[in] value The value to set atomically into the target
|
|
/// @return The value that was last stored in the target
|
|
DQN_FORCE_INLINE long Dqn_Atomic_SetValue32(long volatile *target, long value)
|
|
{
|
|
#if defined(DQN_COMPILER_W32_MSVC) || defined(DQN_COMPILER_W32_CLANG)
|
|
long result;
|
|
do {
|
|
result = *target;
|
|
} while (Dqn_Atomic_CompareExchange32(target, value, result) != result);
|
|
return result;
|
|
#elif defined(DQN_COMPILER_GCC) || defined(DQN_COMPILER_CLANG)
|
|
long result = __sync_lock_test_and_set(target, value);
|
|
return result;
|
|
#else
|
|
#error Unsupported compiler
|
|
#endif
|
|
}
|
|
|
|
#if !defined(DQN_OS_ARM64)
|
|
struct Dqn_CPUIDRegisters
|
|
{
|
|
Dqn_uint array[4]; ///< Values from 'CPUID' instruction for each register (EAX, EBX, ECX, EDX)
|
|
};
|
|
|
|
/// Execute 'CPUID' instruction to query the capabilities of the current CPU.
|
|
Dqn_CPUIDRegisters Dqn_CPUID(int function_id);
|
|
#endif // DQN_OS_ARM64
|
|
|
|
// =================================================================================================
|
|
// [$TMUT] Dqn_TicketMutex | | Userland mutex via spinlocking atomics
|
|
// =================================================================================================
|
|
// A mutex implemented using an atomic compare and swap on tickets handed out
|
|
// for each critical section.
|
|
//
|
|
// This mutex serves ticket in order and will block all other threads until the
|
|
// tickets are returned in order. The thread with the oldest ticket that has
|
|
// not been returned has right of way to execute, all other threads will be
|
|
// blocked in an atomic compare and swap loop. block execution by going into an
|
|
// atomic
|
|
//
|
|
// When a thread is blocked by this mutex, a spinlock intrinsic `_mm_pause` is
|
|
// used to yield the CPU and reduce spinlock on the thread. This mutex is not
|
|
// ideal for long blocking operations. This mutex does not issue any syscalls
|
|
// and relies entirely on atomic instructions.
|
|
//
|
|
// NOTE: API
|
|
//
|
|
// @proc Dqn_TicketMutex_Begin, End
|
|
// @desc Lock and unlock the mutex respectively
|
|
//
|
|
// @proc Dqn_TicketMutex_MakeTicket
|
|
// @desc Allocate the next available ticket from the mutex for locking using
|
|
// Dqn_TicketMutex_BeginTicket().
|
|
// @param[in] mutex The mutex
|
|
// @code
|
|
// Dqn_TicketMutex mutex = {};
|
|
// unsigned int ticket = Dqn_TicketMutex_MakeTicket(&mutex);
|
|
// Dqn_TicketMutex_BeginTicket(&mutex, ticket); // Blocking call until we attain the lock
|
|
// Dqn_TicketMutex_End(&mutex);
|
|
// @endcode
|
|
//
|
|
// @proc Dqn_TicketMutex_BeginTicket
|
|
// @desc Lock the mutex using the given ticket if possible, otherwise block
|
|
// waiting until the mutex can be locked.
|
|
//
|
|
// @proc Dqn_TicketMutex_CanLock
|
|
// @desc Determine if the mutex can be locked using the given ticket number
|
|
|
|
struct Dqn_TicketMutex
|
|
{
|
|
unsigned int volatile ticket; ///< The next ticket to give out to the thread taking the mutex
|
|
unsigned int volatile serving; ///< The ticket ID to block the mutex on until it is returned
|
|
};
|
|
|
|
void Dqn_TicketMutex_Begin (Dqn_TicketMutex *mutex);
|
|
void Dqn_TicketMutex_End (Dqn_TicketMutex *mutex);
|
|
Dqn_uint Dqn_TicketMutex_MakeTicket (Dqn_TicketMutex *mutex);
|
|
void Dqn_TicketMutex_BeginTicket(Dqn_TicketMutex const *mutex, Dqn_uint ticket);
|
|
bool Dqn_TicketMutex_CanLock (Dqn_TicketMutex const *mutex, Dqn_uint ticket);
|
|
|
|
// =================================================================================================
|
|
// [$CALL] Dqn_CallSite | | Source code location/tracing
|
|
// =================================================================================================
|
|
typedef struct Dqn_CallSite {
|
|
Dqn_String8 file;
|
|
Dqn_String8 function;
|
|
unsigned int line;
|
|
} Dqn_CalSite;
|
|
|
|
#define DQN_CALL_SITE Dqn_CallSite{DQN_STRING8(__FILE__), DQN_STRING8(__func__), __LINE__}
|