message_collector Class Reference

A test version of the message collector for use in unit tests. More...

#include "test.h"

Inheritance diagram for message_collector:

Collaboration diagram for message_collector:

Public Member Functions
	message_collector (dpp::cluster *cl, uint64_t duration)
virtual void	cancel ()
	Immediately cancels the collector. More...
virtual void	completed (const std::vector< C > &list)=0
	You must implement this function to receive the completed list of captured objects. More...
virtual void	completed (const std::vector< dpp::message > &list)
	Return the completed collection. More...
virtual const dpp::message *	filter (const dpp::message_create_t &element)
	Select and filter the items which are to appear in the list This is called every time a new event is fired, to filter the event and determine which of the items is sent to the list. More...
virtual const C *	filter (const T &element)=0
	Filter the list of elements. More...

Protected Attributes
class cluster *	owner
	Owning cluster. More...

Detailed Description

A test version of the message collector for use in unit tests.

Constructor & Destructor Documentation

message_collector()

message_collector::message_collector ( dpp::cluster *  cl, uint64_t  duration  )

inline

Member Function Documentation

cancel()

template<class T , class C >

virtual void dpp::collector< T, C >::cancel ( )

inlinevirtualinherited

Immediately cancels the collector.

Use this if you have met the conditions for which you are collecting objects early, e.g. you were watching for a message containing 'yes' or 'no' and have received it before the time is up.

Note

Causes calling of the completed() method if it has not yet been called.

completed() [1/2]

template<class T , class C >

virtual void dpp::collector< T, C >::completed ( const std::vector< C > &  list )

pure virtualinherited

You must implement this function to receive the completed list of captured objects.

Parameters

list	The list of captured objects in captured order

completed() [2/2]

virtual void message_collector::completed ( const std::vector< dpp::message > &  list )

inlinevirtual

Return the completed collection.

Parameters

list	items collected during the timeframe specified

Implements dpp::message_collector.

References MSGCOLLECT, and set_test().

Here is the call graph for this function:

filter() [1/2]

virtual const dpp::message* dpp::message_collector::filter ( const dpp::message_create_t &  element )

inlinevirtualinherited

Select and filter the items which are to appear in the list This is called every time a new event is fired, to filter the event and determine which of the items is sent to the list.

Returning nullptr excludes the item from the list.

Parameters

element

element to filter

Returns

Returned item to add to the list, or nullptr to skip adding this element

filter() [2/2]

template<class T , class C >

virtual const C* dpp::collector< T, C >::filter ( const T &  element )

pure virtualinherited

Filter the list of elements.

Every time an event is fired on the collector, this method wil be called to determine if we should add an object to the list or not. This function can then process the element value, extract the parts which are to be saved to a list (e.g. a dpp::message out of a dpp::message_create_t) and return it as the return value. Returning a value of nullptr causes no object to be stored.

Here is an example of how to filter messages which have specific text in them. This should be used with the specialised type dpp::message_collector

virtual const dpp::message* filter(const dpp::message_create_t& m) {
     if (m.msg.content.find("something i want") != std::string::npos) {
     return &m.msg;
  } else {
     return nullptr;
  }
}

Parameters

element

The event data to filter

Returns

const C* Returned object or nullptr

Member Data Documentation

owner

template<class T , class C >

class cluster* dpp::collector< T, C >::owner

protectedinherited

Owning cluster.

---

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

• test.h