UCommon
Public Member Functions | Protected Attributes
ucommon::auto_protect Class Reference

A mutex locked object smart pointer helper class. More...

#include <thread.h>

Inheritance diagram for ucommon::auto_protect:
Inheritance graph
[legend]

Public Member Functions

 auto_protect (const void *object)
 Construct a protected pointer referencing an existing object.
 operator bool () const
 Test if the pointer is referencing an object.
bool operator! () const
 Test if the pointer is not set.
void operator= (const void *object)
 Set our pointer to a specific object.
void release (void)
 Manually release the pointer.
 ~auto_protect ()
 Delete protected pointer.

Protected Attributes

const void * object

Detailed Description

A mutex locked object smart pointer helper class.

This is particularly useful in referencing objects which will be protected by the mutex protect function. When the pointer falls out of scope, the protecting mutex is also released. This is meant to be used by the typed mutex_pointer template.

Author:
David Sugar <dyfet@gnutelephony.org>

Definition at line 1115 of file thread.h.


Constructor & Destructor Documentation

ucommon::auto_protect::auto_protect ( const void *  object)

Construct a protected pointer referencing an existing object.

Parameters:
objectwe point to.

Delete protected pointer.

When it falls out of scope the associated mutex is released.


Member Function Documentation

ucommon::auto_protect::operator bool ( ) const [inline]

Test if the pointer is referencing an object.

Returns:
true if the pointer is currently referencing an object.

Definition at line 1155 of file thread.h.

bool ucommon::auto_protect::operator! ( ) const [inline]

Test if the pointer is not set.

Returns:
true if the pointer is not referencing anything.

Definition at line 1148 of file thread.h.

void ucommon::auto_protect::operator= ( const void *  object)

Set our pointer to a specific object.

If the pointer currently references another object, the associated mutex is released. The pointer references our new object and that new object is locked.

Parameters:
objectto assign to.

Manually release the pointer.

This releases the mutex.


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