sbk::core::database_ptr< TObject > Class Template Reference

#include <database_ptr.h>

Inheritance diagram for sbk::core::database_ptr< TObject >:

Public Types
using	TThisType = database_ptr< TObject >
using	TIdentifierType = sbk_id
using	TObjectPtr = TObject *
using	TObjectRef = TObject &
using	TObjectWeak = std::weak_ptr< database_object >
using	TObjectShared = std::shared_ptr< TObject >
using	TPtrType = std::weak_ptr< database_object >

Public Member Functions
	database_ptr ()
	Creates an empty and null LazyPtr.
	database_ptr (const TThisType &other)=default
	database_ptr (TThisType &&other)=default
	database_ptr (sbk_id id)
	Creates a LazyPtr that can lookup its object pointer after construction.
	database_ptr (const TObjectShared &object)
	Create a valid LazyPtr.
	database_ptr (const TObjectPtr &object)
	Create a valid LazyPtr.
	database_ptr (std::nullptr_t)
	Create an empty and null LazyPtr.
sbk_id	id () const noexcept
	Get ID of the referenced object.
TObjectShared	shared () const noexcept
TObjectWeak	weak () const noexcept
TObjectPtr	raw () const noexcept
	Get raw pointer of the referenced object.
TObjectPtr	lookupRaw () const noexcept
bool	hasId () const
	Returns true if we hold a valid ID and can search for an object at runtime.
bool	null () const
	Returns true if the object pointer is not set.
bool	pending () const
	Returns true if we hold an ID but haven't found the live object to point to yet.
bool	stale () const
	Returns true if we previously referenced an object that has been destroyed.
bool	valid () const
	Returns true if we hold an ID and a valid pointer to the object.
bool	lookup () const
	Find the live object referenced by the ID and store it.
void	reset (TObjectPtr object=nullptr)
	Clear all references.
TThisType &	operator= (TObjectShared object)
TThisType &	operator= (TObjectPtr object)
	Assign this LazyPtr to a new object, potentially destroying the current object if we're acting as a UniquePtr.
TThisType &	operator= (const TThisType &other)
TThisType &	operator= (const TThisType &&other)
	operator bool () const
	Returns true if this LazyPtr references a valid object.
bool	operator! () const
	Returns true if this LazyPtr is invalid.
TObjectPtr	operator-> () const
	Access the raw object.

Protected Attributes
sbk_id	m_objectID
TPtrType	m_objectPtr = TPtrType()
bool	m_null

Detailed Description

template<typename TObject>
class sbk::core::database_ptr< TObject >

Lazy Pointer Lazy pointers store an Indentifier to an object and use it to find the object later Lazy pointers can be serialized so references can persist through multiple shutdowns Passing only an indentifier will create a pointer that references no object but will try to find the object when accessing the object

Constructor & Destructor Documentation

database_ptr() [1/4]

template<typename TObject >

sbk::core::database_ptr< TObject >::database_ptr ( sbk_id  id )

inline

Creates a LazyPtr that can lookup its object pointer after construction.

Parameters

id	ID of the object to reference

database_ptr() [2/4]

template<typename TObject >

sbk::core::database_ptr< TObject >::database_ptr ( const TObjectShared &  object )

inline

Create a valid LazyPtr.

Parameters

object

database_ptr() [3/4]

template<typename TObject >

sbk::core::database_ptr< TObject >::database_ptr ( const TObjectPtr &  object )

inline

Create a valid LazyPtr.

Parameters

object

database_ptr() [4/4]

template<typename TObject >

sbk::core::database_ptr< TObject >::database_ptr ( std::nullptr_t  )

inline

Create an empty and null LazyPtr.

Parameters

nullptr_t

Member Function Documentation

hasId()

template<typename TObject >

bool sbk::core::database_ptr< TObject >::hasId ( ) const

inline

Returns true if we hold a valid ID and can search for an object at runtime.

Returns

id()

template<typename TObject >

sbk_id sbk::core::database_ptr< TObject >::id ( ) const

inlinenoexcept

Get ID of the referenced object.

Returns

lookup()

template<typename TObject >

bool sbk::core::database_ptr< TObject >::lookup ( ) const

inline

Find the live object referenced by the ID and store it.

Returns

true if the object was found and we're a valid ptr

null()

template<typename TObject >

bool sbk::core::database_ptr< TObject >::null ( ) const

inline

Returns true if the object pointer is not set.

Returns

operator->()

template<typename TObject >

TObjectPtr sbk::core::database_ptr< TObject >::operator-> ( ) const

inline

Access the raw object.

Returns

raw object

operator=()

template<typename TObject >

TThisType & sbk::core::database_ptr< TObject >::operator= ( TObjectPtr  object )

inline

Assign this LazyPtr to a new object, potentially destroying the current object if we're acting as a UniquePtr.

Parameters

object

to assign to

Returns

this

pending()

template<typename TObject >

bool sbk::core::database_ptr< TObject >::pending ( ) const

inline

Returns true if we hold an ID but haven't found the live object to point to yet.

Returns

raw()

template<typename TObject >

TObjectPtr sbk::core::database_ptr< TObject >::raw ( ) const

inlinenoexcept

Get raw pointer of the referenced object.

Returns

stale()

template<typename TObject >

bool sbk::core::database_ptr< TObject >::stale ( ) const

inline

Returns true if we previously referenced an object that has been destroyed.

Returns

valid()

template<typename TObject >

bool sbk::core::database_ptr< TObject >::valid ( ) const

inline

Returns true if we hold an ID and a valid pointer to the object.

Returns

---

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

• /var/www/soundbakery/sound-bakery/src/sound_bakery/core/core_fwd.h
• /var/www/soundbakery/sound-bakery/src/sound_bakery/core/database/database_ptr.h