Thread management and synchronization methods

Types

• Luna::IMutex

  This\ type\ is\ thread\ safe. Represents a system-level mutex object.

• Luna::MutexGuard

  A RAII wrapper for one mutex object that releases the mutex automatically when the wrapper is destructed.

• Luna::IReadWriteLock

  Represents one system-level read write lock.

• Luna::ISemaphore

  Represents one system-level semaphore object.

• Luna::ISignal

  Represents a system-level signal object. This\ type\ is\ thread\ safe.

• Luna::SpinLock

  Provides one spin lock that can give one thread exclusive access to one resource in multi-thread environments.

• Luna::RecursiveSpinLock

  Similar to SpinLock, but allows the lock to be obtained mutable times from the same thread.

• Luna::LockGuard

  The RAII wrapper that locks the specified lock upon construction, and unlocks the specified lock upon destruction.

• Luna::IThread

  Represents a system thread object. This\ type\ is\ thread\ safe.

• Luna::IWaitable

  Represents a waitable object used for multi-thread synchronization.

Enumerations

• Luna::ThreadPriority

  Specifies the thread schedule priority.

Functions

• Ref< IMutex > new_mutex()

  Creates a new mutex object.

• Ref< IReadWriteLock > new_read_write_lock()

  Creates one new read write lock.

• Ref< ISemaphore > new_semaphore(i32 initial_count, i32 max_count)

  Create a new semaphore object.

• Ref< ISignal > new_signal(bool manual_reset)

  Create a new signal object.

• u32 get_processors_count()

  Gets the number of logical processors on the platform.

• Ref< IThread > new_thread(void(entry_func)(void params), void params, const c8 name=nullptr, u32 stack_size=0)

  Create a new system thread and make it run the callback function. The thread will be closed when the callback function returns.

• IThread * get_current_thread()

  Gets the thread object of current running thread.

• IThread * get_main_thread()

  Gets the thread object of the main thread.

• void sleep(u32 time_milliseconds)

  Suspends current thread for a specific period of time.

• void fast_sleep(u32 time_microseconds)

  Delays the execution of this thread for a very shout time by yielding this thread several times.

• void yield_current_thread()

  Yields the remain time slice of the current thread and let OS to schedule other threads.

• opaque_t tls_alloc(void(destructor)(void ptr)=nullptr)

  Allocates one thread local storage (TLS) slot.

• void tls_free(opaque_t handle)

  Frees the TLS slot allocated by tls_alloc.

• void tls_set(opaque_t handle, void *ptr)

  Set the data bound to the current thread's TLS slot specified by handle.

• void * tls_get(opaque_t handle)

  Get the value bound to the TLS slot of current thread.