Eclipse SUMO - Simulation of Urban MObility
Command Class Referenceabstract

Base (microsim) event class. More...

#include <Command.h>

Inheritance diagram for Command:
Collaboration diagram for Command:

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 52 of file Command.h.

Constructor & Destructor Documentation

◆ Command()

Command::Command ( )
inline

Constructor.

Definition at line 55 of file Command.h.

◆ ~Command()

virtual Command::~Command ( )
inlinevirtual

Destructor.

Definition at line 59 of file Command.h.

Member Function Documentation

◆ execute()

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, MSPModel_Remote::Event, WrappingCommand< T >, WrappingCommand< MSDevice_Routing >, WrappingCommand< MSDevice_ToC >, WrappingCommand< MSTransportableDevice_Routing >, StaticCommand< T >, ParametrisedWrappingCommand< T, S >, MSLaneSpeedTrigger, MSCalibrator::CalibratorCommand, MSCalibrator, MSTrafficLightLogic::SwitchCommand, MSPModel_Striping::MovePedestrians, MSPModel_NonInteracting::MoveToNextEdge, MSPerson::MSPersonStage_Access::ProceedCmd, MSVTypeProbe, MSCModel_NonInteracting::MoveToNextEdge, MSDevice_BTreceiver::BTreceiverUpdate, Command_SaveTLSSwitchStates, Command_SaveTLSSwitches, Command_SaveTLSState, Command_SaveTLSProgram, and METriggeredCalibrator.

Referenced by MSEventControl::execute().


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