Quick Links:

bal | bbl | bdl | bsl

Public Member Functions

bslmt::ReaderWriterMutex Class Reference

#include <bslmt_readerwritermutex.h>

List of all members.

Public Member Functions

 ReaderWriterMutex ()
 ~ReaderWriterMutex ()
void lockRead ()
void lockWrite ()
int tryLockRead ()
int tryLockWrite ()
void unlock ()
void unlockRead ()
void unlockWrite ()
bool isLocked () const
bool isLockedRead () const
bool isLockedWrite () const

Detailed Description

This class provides a multi-reader/single-writer lock mechanism.

See Component bslmt_readerwritermutex


Constructor & Destructor Documentation

bslmt::ReaderWriterMutex::ReaderWriterMutex (  ) 

Construct a reader/writer lock initialized to an unlocked state.

bslmt::ReaderWriterMutex::~ReaderWriterMutex (  ) 

Destroy this object


Member Function Documentation

void bslmt::ReaderWriterMutex::lockRead (  ) 

Lock this reader-writer mutex for reading. If there are no active or pending write locks, lock this mutex for reading and return immediately. Otherwise, block until the read lock on this mutex is acquired. Use unlockRead or unlock to release the lock on this mutex. The behavior is undefined if this method is called from a thread that already has a lock on this mutex.

void bslmt::ReaderWriterMutex::lockWrite (  ) 

Lock this reader-writer mutex for writing. If there are no active or pending locks on this mutex, lock this mutex for writing and return immediately. Otherwise, block until the write lock on this mutex is acquired. Use unlockWrite or unlock to release the lock on this mutex. The behavior is undefined if this method is called from a thread that already has a lock on this mutex.

int bslmt::ReaderWriterMutex::tryLockRead (  ) 

Attempt to lock this reader-writer mutex for reading. Immediately return 0 on success, and a non-zero value if there are active or pending writers. If successful, unlockRead or unlock must be used to release the lock on this mutex. The behavior is undefined if this method is called from a thread that already has a lock on this mutex.

int bslmt::ReaderWriterMutex::tryLockWrite (  ) 

Attempt to lock this reader-writer mutex for writing. Immediately return 0 on success, and a non-zero value if there are active or pending locks on this mutex. If successful, unlockWrite or unlock must be used to release the lock on this mutex. The behavior is undefined if this method is called from a thread that already has a lock on this mutex.

void bslmt::ReaderWriterMutex::unlock (  ) 

Release the lock that the calling thread holds on this reader-writer mutex. The behavior is undefined unless the calling thread currently has a lock on this mutex.

void bslmt::ReaderWriterMutex::unlockRead (  ) 

Release the read lock that the calling thread holds on this reader-writer mutex. The behavior is undefined unless the calling thread currently has a read lock on this mutex.

void bslmt::ReaderWriterMutex::unlockWrite (  ) 

Release the write lock that the calling thread holds on this reader-writer mutex. The behavior is undefined unless the calling thread currently has a write lock on this mutex.

bool bslmt::ReaderWriterMutex::isLocked (  )  const

Return true if this reader-write mutex is currently read locked or write locked, and false otherwise.

bool bslmt::ReaderWriterMutex::isLockedRead (  )  const

Return true if this reader-write mutex is currently read locked, and false otherwise.

bool bslmt::ReaderWriterMutex::isLockedWrite (  )  const

Return true if this reader-write mutex is currently write locked, and false otherwise.


The documentation for this class was generated from the following file: