bool StateMachineImp::PostEvent

(

const EventImp &

evt

)

With this function commands are posted to the event queue. If the event loop has not yet been started with Run() the command is directly handled by HandleEvent.

Events posted when the state machine is in a negative state or kSM_FatalError are ignored.

Parameters

evt	The event to be posted. The precise contents depend on what the event should be for.

Returns

false if the event is ignored, true otherwise.

Todo:

• Shell we check for the validity of a command at the current state, too?
• should we also get the output stream as an argument here?

Definition at line 343 of file StateMachineImp.cc.

References fBufferEvents, GetCurrentState(), HandleEvent(), IsRunning(), kSM_FatalError, kYellow, MessageImp::Out(), and PushEvent().

{
    if (/*GetCurrentState()<0 ||*/ GetCurrentState()==kSM_FatalError)
    {
        Out() << kYellow << "State<0 or FatalError: Event ignored." << endl;
        return false;
    }

    if (IsRunning() || fBufferEvents)
        PushEvent(new Event(evt));
    else
    {
        // FIXME: Is this thread safe? (Yes, because it is only used
        // by Dim and this is thread safe) But two handlers could
        // be called at the same time. Do we need to lock the handlers?
        HandleEvent(evt);
    }
    return true;
}

Here is the call graph for this function: