# LightReMutexDirect¶

class LightReMutexDirect

This class implements a standard lightReMutex by making direct calls to the underlying implementation layer. It doesn’t perform any debugging operations.

Inheritance diagram

void acquire(void) const
void acquire(Thread *current_thread) const

Grabs the lightReMutex if it is available. If it is not available, blocks until it becomes available, then grabs it. In either case, the function does not return until the lightReMutex is held; you should then call unlock().

This method is considered const so that you can lock and unlock const lightReMutexes, mainly to allow thread-safe access to otherwise const data.

Also see LightReMutexHolder.

This variant on acquire() accepts the current thread as a parameter, if it is already known, as an optimization.

void clear_name(void)

The mutex name is only defined when compiling in DEBUG_THREADS mode.

bool debug_is_locked(void) const

Returns true if the current thread has locked the LightReMutex, false otherwise. This method is only intended for use in debugging, hence the method name; in the LightReMutexDirect case, it always returns true, since there’s not a reliable way to determine this otherwise.

void elevate_lock(void) const

This method increments the lock count, assuming the calling thread already holds the lock. After this call, release() will need to be called one additional time to release the lock.

This method really performs the same function as acquire(), but it offers a potential (slight) performance benefit when the calling thread knows that it already holds the lock. It is an error to call this when the calling thread does not hold the lock.

std::string get_name(void) const

The mutex name is only defined when compiling in DEBUG_THREADS mode.

bool has_name(void) const

The mutex name is only defined when compiling in DEBUG_THREADS mode.

void output(std::ostream &out) const

This method is declared virtual in MutexDebug, but non-virtual in LightReMutexDirect.

void release(void) const

Releases the lightReMutex. It is an error to call this if the lightReMutex was not already locked.

This method is considered const so that you can lock and unlock const lightReMutexes, mainly to allow thread-safe access to otherwise const data.

void set_name(std::string const &name)

The mutex name is only defined when compiling in DEBUG_THREADS mode.