The Boost Statechart Library - Configuration

The Boost Statechart Library

Configuration

General configuration: Introduction; Debug mode compilation options; Release mode compilation options; Application Defined Macros

General configuration

Introduction

The library uses several configuration macros in <boost/config.hpp>, as well as two configuration macros meant to be supplied by the application. Moreover, two commonly available compiler options also have an impact on the available features.

Debug mode compilation options

C++ RTTI must be turned on (used by various asserts)
C++ exception handling can be turned on or off. When turned off, obviously the library's error handling support is no longer available

Release mode compilation options

C++ RTTI can be turned on or off. When turned off, the use of state_cast<>() leads to a compile time error (state_downcast<>() is still available). Moreover, BOOST_STATECHART_USE_NATIVE_RTTI must not be defined simultaneously
C++ exception handling can be turned on or off. When turned off, obviously the library's error handling support is no longer available

Application Defined Macros

The following macros may be defined by an application using the library:

Both macros need to be consistently defined or undefined for all translation units that are later linked into the same executable. Not doing so will inevitably lead to ODR violations. Depending on compiler and linker technology such violations may or may not manifest themselves in link-time errors.

Revised 05 January, 2008

Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)