SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
Command Class Referenceabstract

Base (microsim) event class. More...

#include <Command.h>

Inheritance diagram for Command:
Command_SaveTLSState Command_SaveTLSSwitches Command_SaveTLSSwitchStates MSCalibrator MSCModel_NonInteracting::MoveToNextEdge MSDevice_BTreceiver::BTreceiverUpdate MSLaneSpeedTrigger MSPModel_NonInteracting::MoveToNextEdge MSPModel_Striping::MovePedestrians MSTLLogicControl::SwitchInitCommand MSTrafficLightLogic::SwitchCommand MSVTypeProbe StaticCommand< T > WrappingCommand< T > WrappingCommand< MSDevice_Routing >

Public Member Functions

 Command ()
 Constructor. More...
 
virtual SUMOTime execute (SUMOTime currentTime)=0
 Executes the command. More...
 
virtual ~Command ()
 Destructor. More...
 

Detailed Description

Base (microsim) event class.

Classes derived from Command may be added to MSEventControl instances in order to be executed at a certain time step.

As soon as the simulation reaches the desired time step, the command (event) is executed by calling "execute" with the current time step. The method must return either 0, if the event shall not be executed again or a positive value (in simulation seconds) that described when it shall be executed again. The method must not return a value below zero, the behaviour is undefined in this case.

Warning
The EventControl the Command is added to gets responsible for this command's deletion.
See also
Design Patterns, Gamma et al.
WrappingCommand
MSEventControl

Definition at line 61 of file Command.h.

Constructor & Destructor Documentation

Command::Command ( )
inline

Constructor.

Definition at line 64 of file Command.h.

virtual Command::~Command ( )
inlinevirtual

Destructor.

Definition at line 68 of file Command.h.

Member Function Documentation

virtual SUMOTime Command::execute ( SUMOTime  currentTime)
pure virtual

Executes the command.

The implementations should return 0 if the command shall not be repeated, or a value larger than 0 that describe the time after which the command shall be executed again. Values below 0 must not be returned.

Parameters
[in]currentTimeThe current simulation time
Returns
The time after which the command shall be executed again, 0 if this command shall be descheduled.
Exceptions
ProcessErrorDerived actions may throw this exception

Implemented in MSTLLogicControl::SwitchInitCommand, MSTrafficLightLogic::SwitchCommand, MSDevice_BTreceiver::BTreceiverUpdate, MSPModel_Striping::MovePedestrians, WrappingCommand< T >, WrappingCommand< MSDevice_Routing >, StaticCommand< T >, MSVTypeProbe, Command_SaveTLSSwitches, MSLaneSpeedTrigger, Command_SaveTLSSwitchStates, MSCModel_NonInteracting::MoveToNextEdge, Command_SaveTLSState, MSPModel_NonInteracting::MoveToNextEdge, and MSCalibrator.

Referenced by MSEventControl::execute().


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