ecl::Signal< Data > Class Template Reference

Signalling component of a callback system. More...

#include <signal.hpp>

Public Member Functions
void	connect (const std::string &topic)
	Make a connection to the specified topic. More...
void	connectAsSlot (const std::string &topic)
	Connect as a slot, with the emit function loaded. More...
void	disconnect ()
	Disconnect the signal from all topics. More...
void	emit (Data data)
	The primary purpose of the signal, to emit! More...
	Signal ()
	Default constructor. More...
	Signal (const Signal &signal)
	Copy constructor. More...
	Signal (const std::string &topic)
	Creates a signal and connects. More...
	~Signal ()
	Default destructor. More...

Private Attributes
SigSlot< Data > *	sigslot

Detailed Description

template<typename Data = Void>
class ecl::Signal< Data >

Signalling component of a callback system.

Anywhere that triggers an event requiring a callback to be executed can be implemented with a signal. These can be placed anywhere in your code and with slots, provide a many to many callback solution.

Usage examples are provided in the main page's documentation for this package.

See also

Signal<Void>, Slot.

Definition at line 53 of file signal.hpp.

Constructor & Destructor Documentation

Signal() [1/3]

template<typename Data = Void>

ecl::Signal< Data >::Signal ( )

inline

Default constructor.

This creates a signal with no connections yet established. Use with connect().

Definition at line 69 of file signal.hpp.

Signal() [2/3]

template<typename Data = Void>

ecl::Signal< Data >::Signal ( const std::string &  topic )

inline

Creates a signal and connects.

Definition at line 75 of file signal.hpp.

Signal() [3/3]

template<typename Data = Void>

ecl::Signal< Data >::Signal ( const Signal< Data > &  signal )

inline

Copy constructor.

This is specially designed so that copying a signal is perfectly acceptable. Copies do not increase the number of emits that are fired - they just preserve the signal when used with things like stl containers. When the last copy disappears, the object destroys its connection automagically.

Parameters

signal

: the object to be copied.

Definition at line 91 of file signal.hpp.

~Signal()

template<typename Data = Void>

ecl::Signal< Data >::~Signal ( )

inline

Default destructor.

This handles the cleanup operation, first decrementing and then checking if its the last of its instance. If it is, it cleans up the sigslot connection with the sigslots manager.

Definition at line 103 of file signal.hpp.

Member Function Documentation

connect()

template<typename Data = Void>

void ecl::Signal< Data >::connect ( const std::string &  topic )

inline

Make a connection to the specified topic.

This contacts the sigslots manager to connect the signal to the specified topic - creating the topic if it is not yet existing.

Parameters

topic

: the topic to connect to.

Definition at line 118 of file signal.hpp.

connectAsSlot()

template<typename Data = Void>

void ecl::Signal< Data >::connectAsSlot ( const std::string &  topic )

inline

Connect as a slot, with the emit function loaded.

This allows the signal to act as a relaying signal (effectively a slot with the emit() function loaded.

Parameters

topic

: the topic to connect to.

Definition at line 127 of file signal.hpp.

disconnect()

template<typename Data = Void>

void ecl::Signal< Data >::disconnect ( )

inline

Disconnect the signal from all topics.

This completely disconnects the signal.

Definition at line 133 of file signal.hpp.

emit()

template<typename Data = Void>

void ecl::Signal< Data >::emit ( Data  data )

inline

The primary purpose of the signal, to emit!

Emits a signal with the specified data.

Parameters

data	: the data to emit.

Definition at line 142 of file signal.hpp.

Member Data Documentation

sigslot

template<typename Data = Void>

SigSlot<Data>* ecl::Signal< Data >::sigslot

private

Definition at line 145 of file signal.hpp.

---

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

• signal.hpp