Panda3D
|
This class implements a standard lightReMutex by making direct calls to the underlying implementation layer. More...
#include "lightReMutexDirect.h"
Public Member Functions | |
void | acquire () const |
Grabs the lightReMutex if it is available. | |
void | acquire (Thread *current_thread) const |
This variant on acquire() accepts the current thread as a parameter, if it is already known, as an optimization. | |
void | clear_name () |
The mutex name is only defined when compiling in DEBUG_THREADS mode. | |
bool | debug_is_locked () const |
Returns true if the current thread has locked the LightReMutex, false otherwise. | |
void | elevate_lock () const |
This method increments the lock count, assuming the calling thread already holds the lock. | |
string | get_name () const |
The mutex name is only defined when compiling in DEBUG_THREADS mode. | |
bool | has_name () const |
The mutex name is only defined when compiling in DEBUG_THREADS mode. | |
void | output (ostream &out) const |
This method is declared virtual in MutexDebug, but non-virtual in LightReMutexDirect. | |
void | release () const |
Releases the lightReMutex. | |
void | set_name (const string &name) |
The mutex name is only defined when compiling in DEBUG_THREADS mode. |
This class implements a standard lightReMutex by making direct calls to the underlying implementation layer.
It doesn't perform any debugging operations.
Definition at line 32 of file lightReMutexDirect.h.
void LightReMutexDirect::acquire | ( | ) | const [inline] |
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.
Definition at line 82 of file lightReMutexDirect.I.
Referenced by LightReMutexHolder::LightReMutexHolder().
void LightReMutexDirect::acquire | ( | Thread * | current_thread | ) | const [inline] |
This variant on acquire() accepts the current thread as a parameter, if it is already known, as an optimization.
Definition at line 95 of file lightReMutexDirect.I.
void LightReMutexDirect::clear_name | ( | ) | [inline] |
The mutex name is only defined when compiling in DEBUG_THREADS mode.
Definition at line 177 of file lightReMutexDirect.I.
bool LightReMutexDirect::debug_is_locked | ( | ) | const [inline] |
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.
Definition at line 156 of file lightReMutexDirect.I.
void LightReMutexDirect::elevate_lock | ( | ) | const [inline] |
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.
Definition at line 120 of file lightReMutexDirect.I.
string LightReMutexDirect::get_name | ( | ) | const [inline] |
The mutex name is only defined when compiling in DEBUG_THREADS mode.
Definition at line 198 of file lightReMutexDirect.I.
bool LightReMutexDirect::has_name | ( | ) | const [inline] |
The mutex name is only defined when compiling in DEBUG_THREADS mode.
Definition at line 187 of file lightReMutexDirect.I.
void LightReMutexDirect::output | ( | ostream & | out | ) | const |
This method is declared virtual in MutexDebug, but non-virtual in LightReMutexDirect.
Definition at line 27 of file lightReMutexDirect.cxx.
void LightReMutexDirect::release | ( | ) | const [inline] |
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.
Definition at line 140 of file lightReMutexDirect.I.
void LightReMutexDirect::set_name | ( | const string & | name | ) | [inline] |
The mutex name is only defined when compiling in DEBUG_THREADS mode.
Definition at line 167 of file lightReMutexDirect.I.