Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members Related Pages

# ACE_Weak_Bound_Ptr Class Template Reference

This class implements support for a weak pointer that complements ACE_Strong_Bound_Ptr. More...

`#include <Bound_Ptr.h>`

Collaboration diagram for ACE_Weak_Bound_Ptr:

[legend]
List of all members.

## Public Methods
ACE_EXPLICIT | ACE_Weak_Bound_Ptr (X *p=0)
| Constructor that initializes an ACE_Weak_Bound_Ptr to point to the object immediately. More...
| ACE_Weak_Bound_Ptr (const ACE_Weak_Bound_Ptr< X, ACE_LOCK > &r)
| Copy constructor binds <this> and <r> to the same object. More...
| ACE_Weak_Bound_Ptr (const ACE_Strong_Bound_Ptr< X, ACE_LOCK > &r)
| Constructor binds <this> and <r> to the same object. More...
| ~ACE_Weak_Bound_Ptr (void)
| Destructor. More...
void | operator= (const ACE_Weak_Bound_Ptr< X, ACE_LOCK > &r)
| Assignment operator that binds <this> and <r> to the same object. More...
void | operator= (const ACE_Strong_Bound_Ptr< X, ACE_LOCK > &r)
| Assignment operator that binds <this> and <r> to the same object. More...
int | operator== (const ACE_Weak_Bound_Ptr< X, ACE_LOCK > &r) const
int | operator== (const ACE_Strong_Bound_Ptr< X, ACE_LOCK > &r) const
int | operator== (X *p) const
| Equality operator that returns 1 if the ACE_Weak_Bound_Ptr and the raw pointer point to the same underlying object. More...
int | operator!= (const ACE_Weak_Bound_Ptr< X, ACE_LOCK > &r) const
| Inequality operator, which is the opposite of equality. More...
int | operator!= (const ACE_Strong_Bound_Ptr< X, ACE_LOCK > &r) const
| Inequality operator, which is the opposite of equality. More...
int | operator!= (X *p) const
| Inequality operator, which is the opposite of equality. More...
ACE_Strong_Bound_Ptr< X, ACE_LOCK > | operator-> (void) const
| It returns a temporary strong pointer and makes use of the chaining properties of operator-> to ensure that the underlying object does not disappear while you are using it. More...
ACE_Strong_Bound_Ptr< X, ACE_LOCK > | strong (void) const
| Obtain a strong pointer corresponding to this weak pointer. This function is useful to create a temporary strong pointer for conversion to a reference. More...
X * | unsafe_get (void) const
| Get the pointer value. Warning: this does not affect the reference count of the underlying object, so it may disappear on you while you are using it if you are not careful. More...
void | reset (X *p=0)
| Resets the ACE_Weak_Bound_Ptr to refer to a different underlying object. More...
int | add_ref (void)
| Returns the new reference count on the object. More...
int | remove_ref (void)
| Returns the new reference count on the object. More...
int | null (void) const
| Allows us to check for NULL on all ACE_Weak_Bound_Ptr objects. More...
## Public Attributes
| ACE_ALLOC_HOOK_DECLARE
| Declare the dynamic allocation hooks. More...
## Private Types
typedef ACE_Bound_Ptr_Counter< ACE_LOCK > | COUNTER
| The ACE_Bound_Ptr_Counter type. More...
## Private Attributes
COUNTER * | counter_
| The reference counter. More...
X * | ptr_
| The underlying object. More...
## Friends
class | ACE_Strong_Bound_Ptr< X, ACE_LOCK >

## Detailed Description

### template<class X, class ACE_LOCK>
class ACE_Weak_Bound_Ptr< X, ACE_LOCK >

This class implements support for a weak pointer that complements ACE_Strong_Bound_Ptr.

Unlike ACE_Strong_Bound_Ptr, assigning or copying instances of an ACE_Weak_Bound_Ptr will not automatically increment the reference count of the underlying object. What ACE_Weak_Bound_Ptr does is preserve the knowledge that the object is in fact reference counted, and thus provides an alternative to raw pointers where non-ownership associations must be maintained. When the last instance of an ACE_Strong_Bound_Ptr that references a particular object is destroyed or overwritten, the corresponding ACE_Weak_Bound_Ptr instances are set to NULL.

## Member Typedef Documentation

template<class X, class ACE_LOCK>
typedef ACE_Bound_Ptr_Counter<ACE_LOCK> ACE_Weak_Bound_Ptr::COUNTER`[private]`

| The ACE_Bound_Ptr_Counter type.

## Constructor & Destructor Documentation

template<class X, class ACE_LOCK>
ACE_Weak_Bound_Ptr< X, ACE_LOCK >::ACE_Weak_Bound_Ptr | ( | X * | p = 0 | ) | `[inline]`

| Constructor that initializes an ACE_Weak_Bound_Ptr to point to the object immediately.

template<class X, class ACE_LOCK>
ACE_Weak_Bound_Ptr< X, ACE_LOCK >::ACE_Weak_Bound_Ptr | ( | const ACE_Weak_Bound_Ptr< X, ACE_LOCK > & | r | ) | `[inline]`

| Copy constructor binds <this> and <r> to the same object.

template<class X, class ACE_LOCK>
ACE_Weak_Bound_Ptr< X, ACE_LOCK >::ACE_Weak_Bound_Ptr | ( | const ACE_Strong_Bound_Ptr< X, ACE_LOCK > & | r | ) | `[inline]`

| Constructor binds <this> and <r> to the same object.

template<class X, class ACE_LOCK>
ACE_Weak_Bound_Ptr< X, ACE_LOCK >::~ACE_Weak_Bound_Ptr | ( | void |  | ) | `[inline]`

| Destructor.

## Member Function Documentation

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::add_ref | ( | void |  | ) | `[inline]`

| Returns the new reference count on the object. This function may be used to integrate the bound pointers into an external reference counting mechanism such as those used by COM or CORBA servants.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::null | ( | void |  | ) | const`[inline]`

| Allows us to check for NULL on all ACE_Weak_Bound_Ptr objects.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator!= | ( | X * | p | ) | const`[inline]`

| Inequality operator, which is the opposite of equality.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator!= | ( | const ACE_Strong_Bound_Ptr< X, ACE_LOCK > & | r | ) | const`[inline]`

| Inequality operator, which is the opposite of equality.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator!= | ( | const ACE_Weak_Bound_Ptr< X, ACE_LOCK > & | r | ) | const`[inline]`

| Inequality operator, which is the opposite of equality.

template<class X, class ACE_LOCK>
ACE_Strong_Bound_Ptr< X, ACE_LOCK > ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator-> | ( | void |  | ) | const`[inline]`

| It returns a temporary strong pointer and makes use of the chaining properties of operator-> to ensure that the underlying object does not disappear while you are using it. If you are certain of the lifetimes of the object, and do not want to incur the locking overhead, then use the unsafe_get method instead.

template<class X, class ACE_LOCK>
void ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator= | ( | const ACE_Strong_Bound_Ptr< X, ACE_LOCK > & | rhs | ) | `[inline]`

| Assignment operator that binds <this> and <r> to the same object.

template<class X, class ACE_LOCK>
void ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator= | ( | const ACE_Weak_Bound_Ptr< X, ACE_LOCK > & | rhs | ) | `[inline]`

| Assignment operator that binds <this> and <r> to the same object.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator== | ( | X * | p | ) | const`[inline]`

| Equality operator that returns 1 if the ACE_Weak_Bound_Ptr and the raw pointer point to the same underlying object.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator== | ( | const ACE_Strong_Bound_Ptr< X, ACE_LOCK > & | r | ) | const`[inline]`

| Note: It also returns 1 if both objects have just been instantiated and not used yet.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::operator== | ( | const ACE_Weak_Bound_Ptr< X, ACE_LOCK > & | r | ) | const`[inline]`

| Note: It also returns 1 if both objects have just been instantiated and not used yet.

template<class X, class ACE_LOCK>
int ACE_Weak_Bound_Ptr< X, ACE_LOCK >::remove_ref | ( | void |  | ) | `[inline]`

| Returns the new reference count on the object. This function may be used to integrate the bound pointers into an external reference counting mechanism such as those used by COM or CORBA servants.

template<class X, class ACE_LOCK>
void ACE_Weak_Bound_Ptr< X, ACE_LOCK >::reset | ( | X * | p = 0 | ) | `[inline]`

| Resets the ACE_Weak_Bound_Ptr to refer to a different underlying object.

template<class X, class ACE_LOCK>
ACE_Strong_Bound_Ptr< X, ACE_LOCK > ACE_Weak_Bound_Ptr< X, ACE_LOCK >::strong | ( | void |  | ) | const`[inline]`

| Obtain a strong pointer corresponding to this weak pointer. This function is useful to create a temporary strong pointer for conversion to a reference.

template<class X, class ACE_LOCK>
X * ACE_Weak_Bound_Ptr< X, ACE_LOCK >::unsafe_get | ( | void |  | ) | const`[inline]`

| Get the pointer value. Warning: this does not affect the reference count of the underlying object, so it may disappear on you while you are using it if you are not careful.

## Friends And Related Function Documentation

template<class X, class ACE_LOCK>
friend class ACE_Strong_Bound_Ptr< X, ACE_LOCK >`[friend]`

## Member Data Documentation

template<class X, class ACE_LOCK>
ACE_Weak_Bound_Ptr::ACE_ALLOC_HOOK_DECLARE

| Declare the dynamic allocation hooks.

template<class X, class ACE_LOCK>
COUNTER* ACE_Weak_Bound_Ptr::counter_`[private]`

| The reference counter.

template<class X, class ACE_LOCK>
X* ACE_Weak_Bound_Ptr::ptr_`[private]`

| The underlying object.

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

- Bound_Ptr.h
- Bound_Ptr.i