Main Page Namespace List Class Hierarchy Compound List File List Header Files Namespace Members Compound Members File Members

arg::uncounted_ptr Class Reference

"Smart pointer" template which does not own the referenced object (a counted_ptr is needed to own the object). More...

#include <arg_shared.h>

Class diagram for arg::uncounted_ptr:

List of all members.

Public Members
		uncounted_ptr ()
		"0 initialised" pointer.
		uncounted_ptr (const base_type& rhs)
		Acquire share of ownership from rhs.
		~uncounted_ptr () throw ()
	pointee_type*	get () const
		Returns contents.
	pointee_type*	operator-> () const
		Indirection operator.
	pointee_type&	operator * () const
		Dereference operator.
	uncounted_ptr&	operator= (const base_type& rhs)
		Acquire share of ownership from rhs (and destroy old referent if last owner).
	void	reset (pointee_type* p)
		Delete existing contents (and take ownership of p).
	void	swap (base_type& with) throw ()
		Swaps contents with "with".

Detailed Description

template<typename pointee_type> class arg::uncounted_ptr

"Smart pointer" template which does not own the referenced object (a counted_ptr is needed to own the object).

When there are no owners of the referenced object the pointer becomes zero.

The copy semantics are to copy the reference - "uncounted_ptr" gives weak reference counting (the references do not participate in the ownership) and is copy compatable with "counted_ptr".

counted_ptr and uncounted_ptr are described in an article: Uncounted pointers in C++.

All methods support the strong exception safety guarantee with the proviso that the referenced type must have a non-throwing destructor.