SST::Clock Class Reference

A Clock class. More...

#include <clock.h>

Inheritance diagram for SST::Clock:

Public Types
using	HandlerBase = SSTHandlerBase< bool, Cycle_t >
	Base handler for clock functions.
template<typename classT , typename dataT = void>
using	Handler = SSTHandler< bool, Cycle_t, classT, dataT >
	Used to create handlers for clock. More...
template<typename classT , auto funcT, typename dataT = void>
using	Handler2 = SSTHandler2< bool, Cycle_t, classT, dataT, funcT >
	New style (checkpointable) SSTHandler.

Public Member Functions
	Clock (TimeConverter *period, int priority=CLOCKPRIORITY)
	Create a new clock with a specified period.
void	schedule ()
	Activates this clock object, by inserting into the simulation's timeVortex for future execution.
Cycle_t	getNextCycle ()
	Return the time of the next clock tick.
void	updateCurrentCycle ()
	Update current cycle count - needed at simulation end if clock has run ahead of simulation end and to return correct cycle count in getNextCycle() for clocks that are currently not scheduled.
bool	registerHandler (Clock::HandlerBase *handler)
	Add a handler to be called on this clock's tick.
bool	unregisterHandler (Clock::HandlerBase *handler, bool &empty)
	Remove a handler from the list of handlers to be called on the clock tick.
bool	isHandlerRegistered (Clock::HandlerBase *handler)
	Checks to see if a handler is registered with this clock.
std::string	toString () const override
	Get a string represenation of the event. More...
Public Member Functions inherited from SST::Action
bool	isAction () final
Public Member Functions inherited from SST::Activity
void	setDeliveryTime (SimTime_t time)
	Set the time for which this Activity should be delivered.
SimTime_t	getDeliveryTime () const
	Return the time at which this Activity will be delivered.
int	getPriority () const
	Return the Priority of this Activity.
void	setOrderTag (uint32_t tag)
	Sets the order tag.
uint32_t	getOrderTag () const
	Return the order tag associated with this activity.
uint64_t	getQueueOrder () const
	Returns the queue order associated with this activity.
virtual bool	isEvent ()
Public Member Functions inherited from SST::Core::MemPoolItem
void *	operator new (std::size_t size) noexcept
	Allocates memory from a memory pool for a new Activity.
void	operator delete (void *ptr)
	Returns memory for this Activity to the appropriate memory pool. More...
virtual void	print (const std::string &header, Output &out) const
Public Member Functions inherited from SST::Core::Serialization::serializable_base
virtual const char *	cls_name () const =0
virtual uint32_t	cls_id () const =0
virtual std::string	serialization_name () const =0

Additional Inherited Members
Static Public Attributes inherited from SST::Core::Serialization::serializable
static constexpr uint32_t	NullClsId = std::numeric_limits<uint32_t>::max()
Static Public Attributes inherited from SST::Core::Serialization::serializable_base
static constexpr uint32_t	NullClsId = std::numeric_limits<uint32_t>::max()
Protected Types inherited from SST::Core::Serialization::serializable_base
enum	cxn_flag_t { ConstructorFlag }
Protected Member Functions inherited from SST::Action
void	endSimulation ()
	Called to signal to the Simulation object to end the simulation.
void	endSimulation (SimTime_t end)
	Called to signal to the Simulation object to end the simulation. More...
Protected Member Functions inherited from SST::Activity
void	setPriority (uint64_t priority)
	Set the priority of the Activity.
std::string	getDeliveryTimeInfo () const
	Gets the delivery time info as a string. More...
	ImplementVirtualSerializable (SST::Activity) void setQueueOrder(uint64_t order)
	Set a new Queue order.
Static Protected Member Functions inherited from SST::Core::Serialization::serializable_base
static void	serializable_abort (uint32_t line, const char *file, const char *func, const char *obj)

Detailed Description

A Clock class.

Calls callback functions (handlers) on a specified period

Member Typedef Documentation

Handler

template<typename classT , typename dataT = void>

using SST::Clock::Handler = SSTHandler<bool, Cycle_t, classT, dataT>

Used to create handlers for clock.

The callback function is expected to be in the form of:

bool func(Cycle_t cycle)

In which case, the class is created with:

new Clock::Handler<classname>(this, &classname::function_name)

Or, to add static data, the callback function is:

bool func(Cycle_t cycle, dataT data)

and the class is created with:

new Clock::Handler<classname, dataT>(this, &classname::function_name, data)

In both cases, the boolean that's returned indicates whether the handler should be removed from the list or not. On return of true, the handler will be removed. On return of false, the handler will be left in the clock list.

Member Function Documentation

toString()

std::string SST::Clock::toString ( ) const

overridevirtual

Get a string represenation of the event.

The default version will just use the name of the class, retrieved through the cls_name() function inherited from the serialzable class, which will return the name of the last class to call one of the serialization macros (ImplementSerializable(), ImplementVirtualSerializable(), or NotSerializable()). Subclasses can override this function if they want to add additional information.

Reimplemented from SST::Activity.

References SST::Activity::getDeliveryTime(), SST::TimeConverter::getFactor(), and SST::Activity::getPriority().

---

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

• src/sst/core/clock.h
• src/sst/core/clock.cc