DGtal::CowPtr< T > Class Template Reference

#include <DGtal/base/CowPtr.h>

Inheritance diagram for DGtal::CowPtr< T >:

Public Types
typedef T	element_type

Public Member Functions
	CowPtr (T *p=0) noexcept
	CowPtr (const CowPtr &r) noexcept
	CowPtr (const CountedPtr< T > &r)
CowPtr &	operator= (const CowPtr &r)
const T &	operator* () const noexcept
const T *	operator-> () const noexcept
const T *	get () const noexcept
template<typename U = T, typename std::enable_if< ! std::is_const< U >::value >::type * = nullptr>
T &	operator* ()
template<typename U = T, typename std::enable_if< ! std::is_const< U >::value >::type * = nullptr>
T *	operator-> ()
template<typename U = T, typename std::enable_if< ! std::is_const< U >::value >::type * = nullptr>
T *	get ()
bool	operator== (const T *other) const
bool	operator!= (const T *other) const
unsigned int	count () const
T *	drop ()
bool	unique () const noexcept
void	selfDisplay (std::ostream &out) const
bool	isValid () const

Private Member Functions
void	copy ()

Private Attributes
CountedPtr< T >	myPtr

Detailed Description

template<typename T>
class DGtal::CowPtr< T >

Aim: Copy on write shared pointer.

Description of template class 'CowPtr'

Use reference counting as long as the pointed object is not modified. When it is about to be modified, copy it and modify the copy.

Taken from http://ootips.org/yonat/4dev/smart-pointers.html

Definition at line 67 of file CowPtr.h.

Member Typedef Documentation

element_type

template<typename T>

typedef T DGtal::CowPtr< T >::element_type

Definition at line 72 of file CowPtr.h.

Constructor & Destructor Documentation

CowPtr() [1/3]

template<typename T>

DGtal::CowPtr< T >::CowPtr ( T *  p = 0 )

inlineexplicitnoexcept

Definition at line 74 of file CowPtr.h.

: myPtr(p) {}

CowPtr() [2/3]

template<typename T>

DGtal::CowPtr< T >::CowPtr ( const CowPtr< T > &  r )

inlinenoexcept

Definition at line 76 of file CowPtr.h.

: myPtr(r.myPtr) {}

CowPtr() [3/3]

template<typename T>

DGtal::CowPtr< T >::CowPtr ( const CountedPtr< T > &  r )

inline

Todo:

JOL: check this.

Definition at line 80 of file CowPtr.h.

: myPtr( r ) {}

Member Function Documentation

copy()

template<typename T>

void DGtal::CowPtr< T >::copy ( )

inlineprivate

Definition at line 160 of file CowPtr.h.

Referenced by DGtal::CowPtr< Domain >::get(), DGtal::CowPtr< Domain >::operator*(), and DGtal::CowPtr< Domain >::operator->().

    {
        if (!myPtr.unique()) {
            T* old_p = myPtr.get();
            myPtr = CountedPtr<T>(new T(*old_p));
        }
    }

count()

template<typename T>

unsigned int DGtal::CowPtr< T >::count ( ) const

inline

For debug.

Definition at line 147 of file CowPtr.h.

{ return myPtr.count(); }

drop()

template<typename T>

T* DGtal::CowPtr< T >::drop ( )

inline

Definition at line 148 of file CowPtr.h.

{ return myPtr.drop(); }

get() [1/2]

template<typename T>

const T* DGtal::CowPtr< T >::get ( ) const

inlinenoexcept

Definition at line 91 of file CowPtr.h.

{return myPtr.get();}

get() [2/2]

template<typename T>

template<typename U = T, typename std::enable_if< ! std::is_const< U >::value >::type * = nullptr>

T* DGtal::CowPtr< T >::get ( )

inline

Definition at line 119 of file CowPtr.h.

{copy(); return myPtr.get();}

isValid()

template<typename T>

bool DGtal::CowPtr< T >::isValid

(

)

const

Checks the validity/consistency of the object.

Returns

'true' if the object is valid, 'false' otherwise.

Referenced by DGtal::Image< TImageContainer >::isValid().

operator!=()

template<typename T>

bool DGtal::CowPtr< T >::operator!= ( const T *  other ) const

inline

Inequality operator !=

Parameters

other

any other pointer.

Returns

'true' if pointed address is different from other.

Definition at line 138 of file CowPtr.h.

    {
      return get() != other;
    }

operator*() [1/2]

template<typename T>

const T& DGtal::CowPtr< T >::operator* ( ) const

inlinenoexcept

Definition at line 89 of file CowPtr.h.

{return *myPtr;}

operator*() [2/2]

template<typename T>

template<typename U = T, typename std::enable_if< ! std::is_const< U >::value >::type * = nullptr>

T& DGtal::CowPtr< T >::operator* ( )

inline

Definition at line 113 of file CowPtr.h.

{copy(); return *myPtr;}

operator->() [1/2]

template<typename T>

const T* DGtal::CowPtr< T >::operator-> ( ) const

inlinenoexcept

Definition at line 90 of file CowPtr.h.

{return myPtr.get();}

operator->() [2/2]

template<typename T>

template<typename U = T, typename std::enable_if< ! std::is_const< U >::value >::type * = nullptr>

T* DGtal::CowPtr< T >::operator-> ( )

inline

Definition at line 116 of file CowPtr.h.

{copy(); return myPtr.get();}

operator=()

template<typename T>

CowPtr& DGtal::CowPtr< T >::operator= ( const CowPtr< T > &  r )

inline

Definition at line 81 of file CowPtr.h.

    {
        if (this != &r)
            myPtr = r.myPtr;
        return *this;
    }

operator==()

template<typename T>

bool DGtal::CowPtr< T >::operator== ( const T *  other ) const

inline

Equality operator ==

Parameters

other

any other pointer.

Returns

'true' if pointed address is equal to other.

Definition at line 127 of file CowPtr.h.

    {
      return get() == other;
    }

selfDisplay()

template<typename T>

void DGtal::CowPtr< T >::selfDisplay

(

std::ostream &

out

)

const

Writes/Displays the object on an output stream.

Parameters

out	the output stream where the object is written.

unique()

template<typename T>

bool DGtal::CowPtr< T >::unique ( ) const

inlinenoexcept

Definition at line 149 of file CowPtr.h.

{ return myPtr.unique(); }

Field Documentation

myPtr

template<typename T>

CountedPtr<T> DGtal::CowPtr< T >::myPtr

private

Definition at line 156 of file CowPtr.h.

Referenced by DGtal::CowPtr< Domain >::copy(), DGtal::CowPtr< Domain >::count(), DGtal::CowPtr< Domain >::drop(), DGtal::CowPtr< Domain >::get(), DGtal::CowPtr< Domain >::operator*(), DGtal::CowPtr< Domain >::operator->(), DGtal::CowPtr< Domain >::operator=(), and DGtal::CowPtr< Domain >::unique().

---

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

• CowPtr.h