AHDispatcher< Key, Operation > Class Template Reference

Tree-based command dispatcher. More...

#include <ah-dispatcher.H>

Collaboration diagram for AHDispatcher< Key, Operation >:

Public Member Functions
	AHDispatcher ()=default
	Default constructor.
template<typename ... Pairs>
	AHDispatcher (const Key &key, Operation op, Pairs ... pairs)
	Variadic constructor for initializing with key-operation pairs.
void	insert (const Key &key, Operation op)
	Register a key-operation pair.
template<typename ... Args>
auto	run (const Key &key, Args &&... args) const
	Execute the operation associated with a key.
void	remove (const Key &key)
	Remove a key-operation pair.
bool	valid_key (const Key &key)
	Check if a key is registered.
DynList< Key >	keys () const
	Get all registered keys.
size_t	size () const
	Get the number of registered operations.
bool	is_empty () const
	Check if the dispatcher is empty.

Private Attributes
DynMapTree< Key, Operation >	tbl

Detailed Description

template<typename Key, class Operation>
class AHDispatcher< Key, Operation >

Tree-based command dispatcher.

Maps keys to operations using a balanced tree (DynMapTree). Provides O(log n) lookup, insertion, and removal.

Template Parameters

Key	The key type (must be comparable with <)
Operation	The callable type (function pointer, std::function, etc.)

Example

// Calculator dispatcher
AHDispatcher<char, double(*)(double, double)> ops;
ops.insert('+', [](double a, double b) { return a + b; });
ops.insert('-', [](double a, double b) { return a - b; });
ops.insert('*', [](double a, double b) { return a * b; });
ops.insert('/', [](double a, double b) { return a / b; });
 
double result = ops.run('+', 10.0, 5.0);  // 15.0

Author

Leandro Rabindranath León

Definition at line 137 of file ah-dispatcher.H.

Constructor & Destructor Documentation

AHDispatcher() [1/2]

template<typename Key , class Operation >

AHDispatcher< Key, Operation >::AHDispatcher ( )

default

Default constructor.

Creates an empty dispatcher.

AHDispatcher() [2/2]

template<typename Key , class Operation >

template<typename ... Pairs>

AHDispatcher< Key, Operation >::AHDispatcher ( const Key &  key, Operation  op, Pairs ...  pairs  )

inline

Variadic constructor for initializing with key-operation pairs.

Parameters

key	First key to register.
op	Operation associated with the key.
pairs	Additional key-operation pairs.

Example

AHDispatcher<std::string, void(*)()> cmds(
  "init", init_func,
  "run", run_func,
  "stop", stop_func
);

Definition at line 164 of file ah-dispatcher.H.

References Aleph::DynMapTree< Key, Data, Tree, Compare >::insert(), and AHDispatcher< Key, Operation >::tbl.

Member Function Documentation

insert()

template<typename Key , class Operation >

void AHDispatcher< Key, Operation >::insert ( const Key &  key, Operation  op  )

inline

Register a key-operation pair.

If the key already exists, its operation is replaced.

Parameters

key	The key to register.
op	The operation to associate with the key.

Definition at line 178 of file ah-dispatcher.H.

References Aleph::DynMapTree< Key, Data, Tree, Compare >::insert(), and AHDispatcher< Key, Operation >::tbl.

is_empty()

template<typename Key , class Operation >

bool AHDispatcher< Key, Operation >::is_empty ( ) const

inline

Check if the dispatcher is empty.

Returns

true if no operations are registered.

Definition at line 245 of file ah-dispatcher.H.

References Aleph::DynSetTree< Key, Tree, Compare >::is_empty(), and AHDispatcher< Key, Operation >::tbl.

keys()

template<typename Key , class Operation >

DynList< Key > AHDispatcher< Key, Operation >::keys ( ) const

inline

Get all registered keys.

Returns

A DynList containing all keys.

Definition at line 231 of file ah-dispatcher.H.

References Aleph::DynMapTree< Key, Data, Tree, Compare >::keys(), and AHDispatcher< Key, Operation >::tbl.

remove()

template<typename Key , class Operation >

void AHDispatcher< Key, Operation >::remove ( const Key &  key )

inline

Remove a key-operation pair.

Parameters

key	The key to remove.

Definition at line 213 of file ah-dispatcher.H.

References Aleph::DynMapTree< Key, Data, Tree, Compare >::remove(), and AHDispatcher< Key, Operation >::tbl.

run()

template<typename Key , class Operation >

template<typename ... Args>

auto AHDispatcher< Key, Operation >::run ( const Key &  key, Args &&...  args  ) const

inline

Execute the operation associated with a key.

Template Parameters

Args	Types of arguments to pass to the operation.

Parameters

key	The key identifying the operation.
args	Arguments to forward to the operation.

Returns

The return value of the operation.

Exceptions

Aborts

if the key is not registered.

Note

Use valid_key() to check before calling if unsure.

Definition at line 196 of file ah-dispatcher.H.

References Aleph::maps(), Aleph::DynMapTree< Key, Data, Tree, Compare >::search(), and AHDispatcher< Key, Operation >::tbl.

size()

template<typename Key , class Operation >

size_t AHDispatcher< Key, Operation >::size ( ) const

inline

Get the number of registered operations.

Returns

The number of key-operation pairs.

Definition at line 238 of file ah-dispatcher.H.

References Aleph::DynSetTree< Key, Tree, Compare >::size(), and AHDispatcher< Key, Operation >::tbl.

valid_key()

template<typename Key , class Operation >

bool AHDispatcher< Key, Operation >::valid_key ( const Key &  key )

inline

Check if a key is registered.

Parameters

key	The key to check.

Returns

true if the key exists, false otherwise.

Definition at line 224 of file ah-dispatcher.H.

References Aleph::DynMapTree< Key, Data, Tree, Compare >::has(), and AHDispatcher< Key, Operation >::tbl.

Member Data Documentation

tbl

template<typename Key , class Operation >

DynMapTree<Key, Operation> AHDispatcher< Key, Operation >::tbl

private

Definition at line 139 of file ah-dispatcher.H.

Referenced by AHDispatcher< Key, Operation >::AHDispatcher(), AHDispatcher< Key, Operation >::insert(), AHDispatcher< Key, Operation >::is_empty(), AHDispatcher< Key, Operation >::keys(), AHDispatcher< Key, Operation >::remove(), AHDispatcher< Key, Operation >::run(), AHDispatcher< Key, Operation >::size(), and AHDispatcher< Key, Operation >::valid_key().

---

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

• ah-dispatcher.H