string StateMachineImp::SetCurrentState ( int  state, const char *  txt = "", const std::string &  cmd = ""  )

protectedvirtual

This is an internal function to do some action in case of a state change, like updating the corresponding service.

This function is a helpter function to do all the corresponding action if the state machine decides to change its state.

If state is equal to the current state (fCurrentState) nothing is done. Then the service STATE (fSrcState) is updated with the new state and the text message and updateService() is called to distribute the update to all clients.

In addition a log message is created and set via UpdateMsg.

Parameters

state	The new state which should be applied
txt	A text corresponding to the state change which is distributed together with the state itself for convinience.
cmd	This argument can be used to give an additional name of the function which is reponsible for the state change. It will be included in the message

Returns

return the new state which was set or -1 in case of no change

Reimplemented in StateMachineDim.

Definition at line 772 of file StateMachineImp.cc.

References fCurrentState, Time::GetAsStr(), GetStateDescription(), MessageImp::Message(), MessageImp::Out(), and str.

Referenced by HandleNewState(), Run(), StateMachineDim::SetCurrentState(), SetNotReady(), SetReady(), and Wrapper().

{
    if (state==fCurrentState)
    {
        Out() << " -- " << Time().GetAsStr("%H:%M:%S.%f") << " - State " << GetStateDescription(state) << " already set... ";
        if (!cmd.empty())
            Out() << "'" << cmd << "' ignored.";
        Out() << endl;
        return "";
    }

    const int old = fCurrentState;

    const string nold = GetStateDescription(old);
    const string nnew = GetStateDescription(state);

    string msg = nnew + " " + txt;
    if (!cmd.empty())
        msg += " (" + cmd + ")";

    fCurrentState = state;

    // State might have changed already again...
    // Not very likely, but possible. That's why state is used
    // instead of fCurrentState.

    ostringstream str;
    str << "State Transition from " << nold << " to " << nnew << " (" << txt;
    if (!cmd.empty())
        str << ": " << cmd;
    str << ")";
    Message(str);

    return msg;
}

Here is the call graph for this function:

Here is the caller graph for this function: