#include <observable.h>

Inheritance diagram for UTIL::OBSERVABLE< ObserverInterface >:

Public Member Functions
	OBSERVABLE ()
	Construct an observable with empty non-shared subscription list.

	OBSERVABLE (OBSERVABLE &aInherit)
	Construct an observable with a shared subscription list.

void	SubscribeUnmanaged (ObserverInterface *aObserver)
	Add a subscription without RAII link.

LINK	Subscribe (ObserverInterface *aObserver)
	Add a subscription returning an RAII link.

void	Unsubscribe (ObserverInterface *aObserver)
	Cancel the subscription of a subscriber.

template<typename... Args1, typename... Args2>
void	Notify (void(ObserverInterface::*Ptr)(Args1...), Args2 &&... aArgs)
	Notify event to all subscribed observers.

template<typename... Args1, typename... Args2>
void	NotifyIgnore (void(ObserverInterface::Ptr)(Args1...), ObserverInterface aIgnore, Args2 &&... aArgs)
	Notify event to all subscribed observers but one to be ignore.

size_t	size () const

Protected Member Functions
void	on_observers_empty ()

void	enter_iteration ()

void	leave_iteration ()

void	add_observer (void *observer)

void	remove_observer (void *observer)

Protected Attributes
std::shared_ptr< IMPL >	impl_

Private Member Functions
void	allocate_impl ()

void	allocate_shared_impl ()

void	deallocate_impl ()

std::shared_ptr< IMPL >	get_shared_impl ()

Detailed Description

template<typename ObserverInterface>
class UTIL::OBSERVABLE< ObserverInterface >

Definition at line 126 of file observable.h.

Constructor & Destructor Documentation

◆ OBSERVABLE() [1/2]

template<typename ObserverInterface>

UTIL::OBSERVABLE< ObserverInterface >::OBSERVABLE ( )

inline

Construct an observable with empty non-shared subscription list.

Definition at line 132 of file observable.h.

Referenced by OBSERVABLE().

◆ OBSERVABLE() [2/2]

template<typename ObserverInterface>

UTIL::OBSERVABLE< ObserverInterface >::OBSERVABLE ( OBSERVABLE< ObserverInterface > & aInherit )

inline

Construct an observable with a shared subscription list.

Parameters

aInherit Observable to share the subscription list with.

Definition at line 139 of file observable.h.

References OBSERVABLE(), and UTIL::DETAIL::OBSERVABLE_BASE::OBSERVABLE_BASE().

Member Function Documentation

◆ add_observer()

void UTIL::DETAIL::OBSERVABLE_BASE::add_observer ( void * observer )

protectedinherited

Definition at line 216 of file observable.cpp.

References allocate_impl(), and impl_.

◆ allocate_impl()

void UTIL::DETAIL::OBSERVABLE_BASE::allocate_impl ( )

privateinherited

Definition at line 188 of file observable.cpp.

References impl_.

Referenced by add_observer().

◆ allocate_shared_impl()

void UTIL::DETAIL::OBSERVABLE_BASE::allocate_shared_impl ( )

privateinherited

Definition at line 195 of file observable.cpp.

References impl_.

Referenced by get_shared_impl().

◆ deallocate_impl()

void UTIL::DETAIL::OBSERVABLE_BASE::deallocate_impl ( )

privateinherited

Definition at line 204 of file observable.cpp.

References impl_.

Referenced by on_observers_empty().

◆ enter_iteration()

void UTIL::DETAIL::OBSERVABLE_BASE::enter_iteration ( )

protectedinherited

Definition at line 230 of file observable.cpp.

References impl_.

Referenced by UTIL::OBSERVABLE< ObserverInterface >::Notify(), and UTIL::OBSERVABLE< ObserverInterface >::NotifyIgnore().

◆ get_shared_impl()

std::shared_ptr< OBSERVABLE_BASE::IMPL > UTIL::DETAIL::OBSERVABLE_BASE::get_shared_impl ( )

privateinherited

Definition at line 209 of file observable.cpp.

References allocate_shared_impl(), and impl_.

Referenced by OBSERVABLE_BASE().

◆ leave_iteration()

void UTIL::DETAIL::OBSERVABLE_BASE::leave_iteration ( )

protectedinherited

Definition at line 237 of file observable.cpp.

References impl_.

Referenced by UTIL::OBSERVABLE< ObserverInterface >::Notify(), and UTIL::OBSERVABLE< ObserverInterface >::NotifyIgnore().

◆ Notify()

template<typename ObserverInterface>

template<typename... Args1, typename... Args2>

void UTIL::OBSERVABLE< ObserverInterface >::Notify	(	void(ObserverInterface::*	Ptr )(Args1...),
		Args2 &&...	aArgs )

inline

Notify event to all subscribed observers.

Parameters

Ptr	is a pointer to method of the observer interface.
aArgs	is a list of arguments to each notification call, will be perfectly forwarded.

Definition at line 182 of file observable.h.

References UTIL::DETAIL::OBSERVABLE_BASE::enter_iteration(), UTIL::DETAIL::OBSERVABLE_BASE::impl_, and UTIL::DETAIL::OBSERVABLE_BASE::leave_iteration().

◆ NotifyIgnore()

template<typename ObserverInterface>

template<typename... Args1, typename... Args2>

void UTIL::OBSERVABLE< ObserverInterface >::NotifyIgnore	(	void(ObserverInterface::*	Ptr )(Args1...),
		ObserverInterface *	aIgnore,
		Args2 &&...	aArgs )

inline

Notify event to all subscribed observers but one to be ignore.

Parameters

Ptr	is a pointer to method of the observer interface.
aIgnore	is an observer to ignore during this notification.
aArgs	is a list of arguments to each notification call, will be perfectly forwarded.

Definition at line 218 of file observable.h.

References UTIL::DETAIL::OBSERVABLE_BASE::enter_iteration(), UTIL::DETAIL::OBSERVABLE_BASE::impl_, and UTIL::DETAIL::OBSERVABLE_BASE::leave_iteration().

◆ on_observers_empty()

void UTIL::DETAIL::OBSERVABLE_BASE::on_observers_empty ( )

protectedinherited

Definition at line 258 of file observable.cpp.

References deallocate_impl().

◆ remove_observer()

void UTIL::DETAIL::OBSERVABLE_BASE::remove_observer ( void * observer )

protectedinherited

Definition at line 223 of file observable.cpp.

References impl_.

◆ size()

size_t UTIL::DETAIL::OBSERVABLE_BASE::size ( ) const

inherited

Definition at line 249 of file observable.cpp.

References impl_.

◆ Subscribe()

template<typename ObserverInterface>

LINK UTIL::OBSERVABLE< ObserverInterface >::Subscribe ( ObserverInterface * aObserver )

inline

Add a subscription returning an RAII link.

Parameters

aObserver observer to subscribe

Returns: RAII link controlling the lifetime of the subscription

Definition at line 157 of file observable.h.

References UTIL::DETAIL::OBSERVABLE_BASE::impl_, and UTIL::DETAIL::OBSERVABLE_BASE::UTIL::LINK.

◆ SubscribeUnmanaged()

template<typename ObserverInterface>

void UTIL::OBSERVABLE< ObserverInterface >::SubscribeUnmanaged ( ObserverInterface * aObserver )

inline

Add a subscription without RAII link.

Parameters

aObserver Observer to subscribe.

Definition at line 146 of file observable.h.

◆ Unsubscribe()

template<typename ObserverInterface>

void UTIL::OBSERVABLE< ObserverInterface >::Unsubscribe ( ObserverInterface * aObserver )

inline

Cancel the subscription of a subscriber.

This can be called during notification calls.

Parameters

aObserver observer to remove from the subscription list.

Definition at line 170 of file observable.h.

Member Data Documentation

◆ impl_

std::shared_ptr<IMPL> UTIL::DETAIL::OBSERVABLE_BASE::impl_

protectedinherited

Definition at line 93 of file observable.h.

Referenced by add_observer(), allocate_impl(), allocate_shared_impl(), deallocate_impl(), enter_iteration(), get_shared_impl(), leave_iteration(), UTIL::OBSERVABLE< ObserverInterface >::Notify(), UTIL::OBSERVABLE< ObserverInterface >::NotifyIgnore(), OBSERVABLE_BASE(), remove_observer(), size(), and UTIL::OBSERVABLE< ObserverInterface >::Subscribe().

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

observable.h

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ OBSERVABLE() [1/2]

◆ OBSERVABLE() [2/2]

Member Function Documentation

◆ add_observer()

◆ allocate_impl()

◆ allocate_shared_impl()

◆ deallocate_impl()

◆ enter_iteration()

◆ get_shared_impl()

◆ leave_iteration()

◆ Notify()

◆ NotifyIgnore()

◆ on_observers_empty()

◆ remove_observer()

◆ size()

◆ Subscribe()

◆ SubscribeUnmanaged()

◆ Unsubscribe()

Member Data Documentation

◆ impl_