Non-owning reference to shared resource. More...

#include <refCntPtr.h>

Inheritance diagram for original::weakPtr< TYPE, DELETER >:

Collaboration diagram for original::weakPtr< TYPE, DELETER >:

Public Member Functions
	weakPtr ()
	Initialize empty weak reference.

	weakPtr (const strongPtr< TYPE, DELETER > &other)
	Construct from strongPtr observer.

weakPtr &	operator= (const strongPtr< TYPE, DELETER > &other)
	Assign observation from strongPtr.

	weakPtr (const weakPtr &other)
	Copy constructor duplicates observation.

weakPtr &	operator= (const weakPtr &other)
	Copy assignment duplicates observation.

	weakPtr (weakPtr &&other) noexcept
	Move constructor transfers observation.

weakPtr &	operator= (weakPtr &&other) noexcept
	Move assignment transfers observation.

strongPtr< TYPE, DELETER >	lock () const
	Attempt to acquire ownership.

const TYPE &	operator* () const override
	Const dereference via temporary strong reference.

const TYPE *	operator-> () const override
	Const member access via temporary strong reference.

const TYPE &	operator[] (u_integer index) const override
	Const array element access via temporary strong reference.

TYPE &	operator* () override
	Mutable dereference via temporary strong reference.

TYPE *	operator-> () override
	Mutable member access via temporary strong reference.

TYPE &	operator[] (u_integer index) override
	Mutable array element access via temporary strong reference.

std::string	className () const override
	Get class type identifier.

	~weakPtr () override
	Destructor releases weak reference.

Public Member Functions inherited from original::refCntPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >
bool	operator== (const refCntPtr< TYPE, O_DERIVED, DELETER > &other) const
	Equality comparison operator.

bool	operator!= (const refCntPtr< TYPE, O_DERIVED, DELETER > &other) const
	Inequality comparison operator.

std::string	toString (bool enter) const override
	Formatted string with reference info.

	~refCntPtr () override=default
	Default destructor of refCntPtr.

Public Member Functions inherited from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >
u_integer	strongRefs () const
	Get strong reference count.

u_integer	weakRefs () const
	Get weak reference count.

bool	exist () const
	Check active ownership.

bool	expired () const
	Check resource validity.

	operator bool () const
	Boolean conversion operator.

const TYPE *	get () const
	Get managed pointer const version.

TYPE *	get ()
	Get managed pointer.

void	swap (autoPtr &other) noexcept
	Swaps the reference counters between two autoPtr instances.

integer	compareTo (const autoPtr &other) const override
	Compare reference counters.

	~autoPtr () override
	Destructor triggers reference cleanup.

Public Member Functions inherited from original::printable
	operator std::string () const
	Explicit conversion to std::string.

	operator const char * () const
	Explicit conversion to C-style string.

const char *	toCString (bool enter) const
	Direct C-string access with formatting control.

template<typename TYPE>
auto	formatString (const TYPE &t) -> std::string

template<typename TYPE>
auto	formatCString (const TYPE &t) -> const char *

template<typename TYPE>
auto	formatEnum (const TYPE &t) -> std::string

template<typename TYPE>
auto	formatString (TYPE *const &ptr) -> std::string

Public Member Functions inherited from original::comparable< autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > >
virtual integer	compareTo (const autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > &other) const=0
	Compares the current object with another of the same type.

bool	operator== (const autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > &other) const
	Checks if the current object is equal to another.

bool	operator!= (const autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > &other) const
	Checks if the current object is not equal to another.

bool	operator< (const autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > &other) const
	Checks if the current object is less than another.

bool	operator> (const autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > &other) const
	Checks if the current object is greater than another.

bool	operator<= (const autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > &other) const
	Checks if the current object is less than or equal to another.

bool	operator>= (const autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER > &other) const
	Checks if the current object is greater than or equal to another.

virtual	~comparable ()=default
	Virtual destructor for proper cleanup of derived objects.

Friends
class	strongPtr< TYPE, DELETER >

Additional Inherited Members
Static Public Member Functions inherited from original::printable
template<typename TYPE>
static std::string	formatString (const TYPE &t)
	Universal value-to-string conversion.

template<typename TYPE>
static std::string	formatString (TYPE *const &ptr)
	Pointer-specific formatting.

template<typename TYPE>
static const char *	formatCString (const TYPE &t)
	C-string cache for temporary usage.

template<typename TYPE>
static std::string	formatEnum (const TYPE &t)
	Enum formatting utility.

template<>
auto	formatString (const char &t) -> std::string

template<>
auto	formatString (const bool &t) -> std::string

template<>
auto	formatString (const char *const &ptr) -> std::string

Protected Member Functions inherited from original::refCntPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >
	refCntPtr (TYPE *p=std::nullptr_t{})
	Construct from raw pointer.

Protected Member Functions inherited from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >
	autoPtr (TYPE *p)
	Construct from raw pointer.

void	setPtr (TYPE *p)
	Replace managed pointer.

void	addStrongRef ()
	Increment strong reference count.

void	addWeakRef ()
	Increment weak reference count.

void	removeStrongRef ()
	Decrement strong reference count.

void	removeWeakRef ()
	Decrement weak reference count.

void	destroyRefCnt () noexcept
	Destroy reference counter.

void	clean () noexcept
	Cleanup resources when expired.

Static Protected Member Functions inherited from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >
static refCount< TYPE, DELETER > *	newRefCount (TYPE *p=nullptr)
	Create new reference counter.

Protected Attributes inherited from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >
refCount< TYPE, DELETER > *	ref_count
	Reference counter object.

Detailed Description

template<typename TYPE, typename DELETER>
class original::weakPtr< TYPE, DELETER >

Non-owning reference to shared resource.

Template Parameters

TYPE	Managed object type
DELETER	Deletion policy type (default: deleter<TYPE>)

Provides safe access to resources managed by strongPtr:

Does not affect object lifetime
Must convert to strongPtr via lock() before access
Automatically expires when all strong references removed

Constructor & Destructor Documentation

◆ weakPtr() [1/3]

template<typename TYPE, typename DELETER>

original::weakPtr< TYPE, DELETER >::weakPtr ( const strongPtr< TYPE, DELETER > & other )

explicit

Construct from strongPtr observer.

Parameters

other Source strongPtr to observe

Creates weak reference to same resource:

Shares reference counter with strongPtr
Increments weak reference count
Does NOT affect strong reference count

◆ weakPtr() [2/3]

template<typename TYPE, typename DELETER>

original::weakPtr< TYPE, DELETER >::weakPtr ( const weakPtr< TYPE, DELETER > & other )

Copy constructor duplicates observation.

Parameters

other Source weakPtr to copy

Shares the same observation target:

Increments weak reference count
No change to strong reference count

◆ weakPtr() [3/3]

template<typename TYPE, typename DELETER>

original::weakPtr< TYPE, DELETER >::weakPtr ( weakPtr< TYPE, DELETER > && other )

noexcept

Move constructor transfers observation.

Parameters

other Source weakPtr to move from

Postcondition: other becomes empty observer

◆ ~weakPtr()

template<typename TYPE, typename DELETER>

original::weakPtr< TYPE, DELETER >::~weakPtr ( )

override

Destructor releases weak reference.

Decrements weak reference count:

Does NOT trigger object destruction
Final weak reference cleans up counter

Member Function Documentation

◆ className()

template<typename TYPE, typename DELETER>

std::string original::weakPtr< TYPE, DELETER >::className ( ) const

nodiscardoverridevirtual

Get class type identifier.

Returns: std::string "weakPtr"

Reimplemented from original::refCntPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >.

◆ lock()

template<typename TYPE, typename DELETER>

strongPtr< TYPE, DELETER > original::weakPtr< TYPE, DELETER >::lock ( ) const

Attempt to acquire ownership.

Returns: strongPtr<TYPE, DELETER> Valid strongPtr if resource exists

Creates temporary strong reference:

Returns empty strongPtr if object destroyed
Increments strong count if successful
Thread-safe atomic reference check
Exceptions

nothing (nothrow guarantee)

◆ operator*() [1/2]

template<typename TYPE, typename DELETER>

const TYPE & original::weakPtr< TYPE, DELETER >::operator* ( ) const

overridevirtual

Const dereference via temporary strong reference.

Returns: const TYPE& Reference to observed object

Reimplemented from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >.

◆ operator*() [2/2]

template<typename TYPE, typename DELETER>

TYPE & original::weakPtr< TYPE, DELETER >::operator* ( )

overridevirtual

Mutable dereference via temporary strong reference.

Returns: Reference to observed object

Reimplemented from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >.

◆ operator->() [1/2]

template<typename TYPE, typename DELETER>

const TYPE * original::weakPtr< TYPE, DELETER >::operator-> ( ) const

overridevirtual

Const member access via temporary strong reference.

Returns: Pointer to observed object

Reimplemented from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >.

◆ operator->() [2/2]

template<typename TYPE, typename DELETER>

TYPE * original::weakPtr< TYPE, DELETER >::operator-> ( )

overridevirtual

Mutable member access via temporary strong reference.

Returns: Pointer to observed object

Reimplemented from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >.

◆ operator=() [1/3]

template<typename TYPE, typename DELETER>

weakPtr< TYPE, DELETER > & original::weakPtr< TYPE, DELETER >::operator= ( const strongPtr< TYPE, DELETER > & other )

Assign observation from strongPtr.

Parameters

other Source strongPtr to observe

Returns: Reference to this weakPtr

Behavior:

Releases current observation (decrements weak count)
Adopts new reference counter from other
Increments new weak reference count
Note
Handles self-assignment safely

◆ operator=() [2/3]

template<typename TYPE, typename DELETER>

weakPtr< TYPE, DELETER > & original::weakPtr< TYPE, DELETER >::operator= ( const weakPtr< TYPE, DELETER > & other )

Copy assignment duplicates observation.

Parameters

other Source weakPtr to copy

Returns: Reference to this weakPtr

Behavior:

Releases current observation
Shares other's reference counter
Increments new weak reference count
Note
Safely handles self-assignment

◆ operator=() [3/3]

template<typename TYPE, typename DELETER>

weakPtr< TYPE, DELETER > & original::weakPtr< TYPE, DELETER >::operator= ( weakPtr< TYPE, DELETER > && other )

noexcept

Move assignment transfers observation.

Parameters

other Source weakPtr to move from

Returns: Reference to this weakPtr

Postcondition: other becomes empty observer

◆ operator[]() [1/2]

template<typename TYPE, typename DELETER>

const TYPE & original::weakPtr< TYPE, DELETER >::operator[] ( u_integer index ) const

overridevirtual

Const array element access via temporary strong reference.

Parameters

index Array position

Returns: Reference to element

Reimplemented from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >.

◆ operator[]() [2/2]

template<typename TYPE, typename DELETER>

TYPE & original::weakPtr< TYPE, DELETER >::operator[] ( u_integer index )

overridevirtual

Mutable array element access via temporary strong reference.

Parameters

index Array position

Returns: Reference to element

Reimplemented from original::autoPtr< TYPE, weakPtr< TYPE, DELETER >, DELETER >.

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

src/core/refCntPtr.h

Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ weakPtr() [1/3]

◆ weakPtr() [2/3]

◆ weakPtr() [3/3]

◆ ~weakPtr()

Member Function Documentation

◆ className()

◆ lock()

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator->() [1/2]

◆ operator->() [2/2]

◆ operator=() [1/3]

◆ operator=() [2/3]

◆ operator=() [3/3]

◆ operator[]() [1/2]

◆ operator[]() [2/2]