qfsm_dis.cpp

00001 //////////////////////////////////////////////////////////////////////////////
00002 // Product: QEP/C++
00003 // Last Updated for Version: 4.0.00
00004 // Date of the Last Update:  Apr 06, 2008
00005 //
00006 //                    Q u a n t u m     L e a P s
00007 //                    ---------------------------
00008 //                    innovating embedded systems
00009 //
00010 // Copyright (C) 2002-2008 Quantum Leaps, LLC. All rights reserved.
00011 //
00012 // This software may be distributed and modified under the terms of the GNU
00013 // General Public License version 2 (GPL) as published by the Free Software
00014 // Foundation and appearing in the file GPL.TXT included in the packaging of
00015 // this file. Please note that GPL Section 2[b] requires that all works based
00016 // on this software must also be made publicly available under the terms of
00017 // the GPL ("Copyleft").
00018 //
00019 // Alternatively, this software may be distributed and modified under the
00020 // terms of Quantum Leaps commercial licenses, which expressly supersede
00021 // the GPL and are specifically designed for licensees interested in
00022 // retaining the proprietary status of their code.
00023 //
00024 // Contact information:
00025 // Quantum Leaps Web site:  http://www.quantum-leaps.com
00026 // e-mail:                  info@quantum-leaps.com
00027 //////////////////////////////////////////////////////////////////////////////
00028 #include "qep_pkg.h"
00029 
00030 /// \file
00031 /// \ingroup qep
00032 /// \brief QFsm::dispatch() implementation.
00033 
00034 //............................................................................
00035 void QFsm::dispatch(QEvent const *e) {
00036     QStateHandler s = m_state;
00037     QS_INT_LOCK_KEY_
00038     QState r = (*s)(this, e);                        // call the event handler
00039 
00040     if (r == Q_RET_TRAN) {                                // transition taken?
00041 
00042         QS_BEGIN_(QS_QEP_TRAN, QS::smObj_, this)
00043             QS_TIME_();                                          // time stamp
00044             QS_SIG_(e->sig);                        // the signal of the event
00045             QS_OBJ_(this);                        // this state machine object
00046             QS_FUN_(s);                        // the source of the transition
00047             QS_FUN_(m_state);                          // the new active state
00048         QS_END_()
00049 
00050         (void)QEP_TRIG_(s, Q_EXIT_SIG);                     // exit the source
00051         (void)QEP_TRIG_(m_state, Q_ENTRY_SIG);             // enter the target
00052     }
00053     else {
00054 #ifdef Q_SPY
00055         if (r == Q_RET_HANDLED) {
00056 
00057             QS_BEGIN_(QS_QEP_INTERN_TRAN, QS::smObj_, this)
00058                 QS_TIME_();                                      // time stamp
00059                 QS_SIG_(e->sig);                    // the signal of the event
00060                 QS_OBJ_(this);                    // this state machine object
00061                 QS_FUN_(s);                // the state that handled the event
00062             QS_END_()
00063 
00064         }
00065         else {
00066 
00067             QS_BEGIN_(QS_QEP_IGNORED, QS::smObj_, this)
00068                 QS_TIME_();                                      // time stamp
00069                 QS_SIG_(e->sig);                    // the signal of the event
00070                 QS_OBJ_(this);                    // this state machine object
00071                 QS_FUN_(m_state);                         // the current state
00072             QS_END_()
00073 
00074         }
00075 #endif
00076     }
00077 }