General purpose event emitter. More...

#include <emitter.hpp>

Public Types
using	allocator_type = Allocator
	Allocator type.

using	size_type = std::size_t
	Unsigned integer type.

Public Member Functions
	emitter ()
	Default constructor.

	emitter (const allocator_type &allocator)
	Constructs an emitter with a given allocator.

virtual	~emitter () noexcept
	Default destructor.

	emitter (emitter &&other) noexcept
	Move constructor.

	emitter (emitter &&other, const allocator_type &allocator) noexcept
	Allocator-extended move constructor.

emitter &	operator= (emitter &&other) noexcept
	Move assignment operator.

void	swap (emitter &other)
	Exchanges the contents with those of a given emitter.

constexpr allocator_type	get_allocator () const noexcept
	Returns the associated allocator.

template<typename Type >
void	publish (Type &&value)
	Publishes a given event.

template<typename Type >
void	on (std::function< void(Type &, Derived &)> func)
	Registers a listener with the event emitter.

template<typename Type >
void	erase ()
	Disconnects a listener from the event emitter.

void	clear () noexcept
	Disconnects all the listeners.

template<typename Type >
bool	contains () const
	Checks if there are listeners registered for the specific event.

bool	empty () const noexcept
	Checks if there are listeners registered with the event emitter.

Detailed Description

template<typename Derived, typename Allocator>
class entt::emitter< Derived, Allocator >

General purpose event emitter.

To create an emitter type, derived classes must inherit from the base as:

struct my_emitter: emitter<my_emitter> {
    // ...
}

Handlers for the different events are created internally on the fly. It's not required to specify in advance the full list of accepted events.
Moreover, whenever an event is published, an emitter also passes a reference to itself to its listeners.

Template Parameters

Derived	Emitter type.
Allocator	Type of allocator used to manage memory and elements.

Definition at line 36 of file emitter.hpp.

Member Typedef Documentation

◆ allocator_type

template<typename Derived , typename Allocator >

using entt::emitter< Derived, Allocator >::allocator_type = Allocator

Allocator type.

Definition at line 46 of file emitter.hpp.

◆ size_type

template<typename Derived , typename Allocator >

using entt::emitter< Derived, Allocator >::size_type = std::size_t

Unsigned integer type.

Definition at line 48 of file emitter.hpp.

Constructor & Destructor Documentation

◆ emitter() [1/4]

template<typename Derived , typename Allocator >

entt::emitter< Derived, Allocator >::emitter ( )

inline

Default constructor.

Definition at line 51 of file emitter.hpp.

◆ emitter() [2/4]

template<typename Derived , typename Allocator >

entt::emitter< Derived, Allocator >::emitter ( const allocator_type & allocator )

inlineexplicit

Constructs an emitter with a given allocator.

Parameters

allocator The allocator to use.

Definition at line 58 of file emitter.hpp.

◆ ~emitter()

template<typename Derived , typename Allocator >

virtual entt::emitter< Derived, Allocator >::~emitter ( )

inlinevirtualnoexcept

Default destructor.

Definition at line 62 of file emitter.hpp.

◆ emitter() [3/4]

template<typename Derived , typename Allocator >

entt::emitter< Derived, Allocator >::emitter ( emitter< Derived, Allocator > && other )

inlinenoexcept

Move constructor.

Parameters

other The instance to move from.

Definition at line 70 of file emitter.hpp.

◆ emitter() [4/4]

template<typename Derived , typename Allocator >

entt::emitter< Derived, Allocator >::emitter	(	emitter< Derived, Allocator > &&	other,
		const allocator_type &	allocator
	)

inlinenoexcept

Allocator-extended move constructor.

Parameters

other	The instance to move from.
allocator	The allocator to use.

Definition at line 78 of file emitter.hpp.

Member Function Documentation

◆ clear()

template<typename Derived , typename Allocator >

void entt::emitter< Derived, Allocator >::clear ( )

inlinenoexcept

Disconnects all the listeners.

Definition at line 146 of file emitter.hpp.

◆ contains()

template<typename Derived , typename Allocator >

template<typename Type >

bool entt::emitter< Derived, Allocator >::contains ( ) const

inline

Checks if there are listeners registered for the specific event.

Template Parameters

Type	Type of event to test.

Returns: True if there are no listeners registered, false otherwise.

Definition at line 156 of file emitter.hpp.

◆ empty()

template<typename Derived , typename Allocator >

bool entt::emitter< Derived, Allocator >::empty ( ) const

inlinenoexcept

Checks if there are listeners registered with the event emitter.

Returns: True if there are no listeners registered, false otherwise.

Definition at line 164 of file emitter.hpp.

◆ erase()

template<typename Derived , typename Allocator >

template<typename Type >

void entt::emitter< Derived, Allocator >::erase ( )

inline

Disconnects a listener from the event emitter.

Template Parameters

Type	Type of event of the listener.

Definition at line 141 of file emitter.hpp.

◆ get_allocator()

template<typename Derived , typename Allocator >

constexpr allocator_type entt::emitter< Derived, Allocator >::get_allocator ( ) const

inlineconstexprnoexcept

Returns the associated allocator.

Returns: The associated allocator.

Definition at line 108 of file emitter.hpp.

◆ on()

template<typename Derived , typename Allocator >

template<typename Type >

void entt::emitter< Derived, Allocator >::on ( std::function< void(Type &, Derived &)> func )

inline

Registers a listener with the event emitter.

Template Parameters

Type	Type of event to which to connect the listener.

Parameters

func	The listener to register.

Definition at line 130 of file emitter.hpp.

◆ operator=()

template<typename Derived , typename Allocator >

emitter & entt::emitter< Derived, Allocator >::operator= ( emitter< Derived, Allocator > && other )

inlinenoexcept

Move assignment operator.

Parameters

other The instance to move from.

Returns: This dispatcher.

Definition at line 88 of file emitter.hpp.

◆ publish()

template<typename Derived , typename Allocator >

template<typename Type >

void entt::emitter< Derived, Allocator >::publish ( Type && value )

inline

Publishes a given event.

Template Parameters

Type	Type of event to trigger.

Parameters

value An instance of the given type of event.

Definition at line 118 of file emitter.hpp.

◆ swap()

template<typename Derived , typename Allocator >

void entt::emitter< Derived, Allocator >::swap ( emitter< Derived, Allocator > & other )

inline

Exchanges the contents with those of a given emitter.

Parameters

other Emitter to exchange the content with.

Definition at line 99 of file emitter.hpp.

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

src/entt/signal/emitter.hpp

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ allocator_type

◆ size_type

Constructor & Destructor Documentation

◆ emitter() [1/4]

◆ emitter() [2/4]

◆ ~emitter()

◆ emitter() [3/4]

◆ emitter() [4/4]

Member Function Documentation

◆ clear()

◆ contains()

◆ empty()

◆ erase()

◆ get_allocator()

◆ on()

◆ operator=()

◆ publish()

◆ swap()