1234567891011121314151617181920212223242526272829303132333435363738394041424344 |
- <html><head>
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
- <title>Chapter 5. Questions & Answers, tips</title><link rel="stylesheet" href="boostbook.css" type="text/css"><meta name="generator" content="DocBook XSL-NS Stylesheets V1.75.2"><link rel="home" href="index.html" title="Meta State Machine (MSM)"><link rel="up" href="pt01.html" title="Part I. User' guide"><link rel="prev" href="ch04s05.html" title="Compilers corner"><link rel="next" href="ch06.html" title="Chapter 6. Internals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 5. Questions & Answers, tips</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch04s05.html">Prev</a> </td><th width="60%" align="center">Part I. User' guide</th><td width="20%" align="right"> <a accesskey="n" href="ch06.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 5. Questions & Answers, tips"><div class="titlepage"><div><div><h2 class="title"><a name="d0e2923"></a>Chapter 5. Questions & Answers, tips</h2></div></div></div><p><span class="underline">Where should I define a state machine?</span>: The
- tutorials are implemented in a simple cpp source file for simplicity. I want to
- model dynamic behavior of a class as a state machine, how should I define the state
- machine?</p><p><span class="underline">Answer</span>: Usually you'll want to implement the
- state machine as an attribute of the class. Unfortunately, a concrete state machine
- is a typedef, which cannot be forward-declared. This leaves you with two
- possibilities: </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Provide the state machine definition inside the header class and
- contain an instance as attribute. Simple, but with several drawbacks:
- using namespace directives are not advised, and compile-time cost for
- all modules including the header.</p></li><li class="listitem"><p>Keep the state machine as (shared) pointer to void inside the <a class="link" href="examples/FsmAsPtr.hpp" target="_top">class definition</a>, and
- implement the state machine in the <a class="link" href="examples/FsmAsPtr.cpp" target="_top">cpp file</a>. Minimum
- compile-time, using directives are okay, but the state machine is now
- located inside the heap.</p></li></ul></div><p><span class="underline">Question</span>: on_entry gets as argument, the
- sent event. What event do I get when the state becomes default-activated (because it
- is an initial state)?</p><p>
- <span class="underline">Answer</span>: To allow you to know that the state
- was default-activated, MSM generates a boost::msm::InitEvent default event. </p><p><span class="underline">Question</span>: Why do I see no call to
- no_transition in my submachine? </p><p><span class="underline">Answer</span>: Because of the priority rule defined
- by UML. It says that in case of transition conflict, the most inner state has a
- higher priority. So after asking the inner state, the containing composite has to be
- also asked to handle the transition and could find a possible transition.</p><p><span class="underline">Question</span>: Why do I get a compile error
- saying the compiler cannot convert to a function ...Fsm::*(some_event)? </p><p><span class="underline">Answer</span>: You probably defined a transition
- triggered by the event some_event, but used a guard/action method taking another
- event. </p><p><span class="underline">Question</span>: Why do I get a compile error
- saying something like “too few” or “too many” template arguments? </p><p><span class="underline">Answer</span>: You probably defined a transition in
- form of a a_row or g_row where you wanted just a _row or the other way around. With
- Row, it could mean that you forgot a "none". </p><p><span class="underline">Question</span>: Why do I get a very long compile
- error when I define more than 20 rows in the transition table? </p><p><span class="underline">Answer</span>: MSM uses Boost.MPL under the hood
- and this is the default maximum size. Please define the following 3 macros before
- including any MSM headers: </p><pre class="programlisting">#define BOOST_MPL_CFG_NO_PREPROCESSED_HEADERS
- #define BOOST_MPL_LIMIT_VECTOR_SIZE 30 // or whatever you need
- #define BOOST_MPL_LIMIT_MAP_SIZE 30 // or whatever you need </pre><p><span class="underline">Question</span>: Why do I get this error: ”error
- C2977: 'boost::mpl::vector' : too many template arguments”? </p><p><span class="underline">Answer</span>: The first possibility is that you
- defined a transition table as, say, vector17 and have 18 entries. The second is that
- you have 17 entries and have a composite state. Under the hood, MSM adds a row for
- every event in the composite transition table. The third one is that you used a
- mpl::vector without the number of entries but are close to the MPL default of 50 and
- have a composite, thus pushing you above 50. Then you need mpl/vector60/70….hpp and
- a mpl/map60/70….hpp </p><p><span class="underline">Question</span>: Why do I get a very long compile
- error when I define more than 10 states in a state machine? </p><p><span class="underline">Answer</span>: MSM uses Boost.Fusion under the hood
- and this is the default maximum size. Please define the following macro before
- including any MSM headers: </p><pre class="programlisting">#define FUSION_MAX_VECTOR_SIZE 20 // or whatever you need </pre></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch04s05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> Compilers corner </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 6. Internals</td></tr></table></div></body></html>
|