ecl_exceptions Documentation

ecl_exceptions: Simple templated exceptions.

Template based exceptions - these are simple and practical and avoid the proliferation of exception types. Although not syntatactically ideal, it is convenient and eminently practical.

• Homepage: http://ros.org/wiki/ecl_exceptions

packageSummary

The embedded control libraries provide and internally make use of a variety of error mechanisms tailored to suit different situations. For lean and mean, there are c style error functions and macros in ecl_errors. At a higher level, there are template based exceptions, these are defined in this library.

These are further enabled via the use of macros which allow code location (file and line #) reporting as well as debug mode only handling.

CompilingLinking

Include the following at the top of any translation unit:

        #include <ecl/exceptions.hpp>

        // The exception classes
        using ecl::StandardException;
        using ecl::DataException;

        // Posix Tools
        using ecl::PosixErrorHandler;

        // Error flags (from ecl_errors)
        using ecl::ConfigurationError;
        using ecl::InvalidInputError;
        //...

You will also need to link to -lecl_exceptions.

Guides

• Exceptions - notes on ecl exception handling.

Examples

• src/examples/exceptions.cpp : coverage style test for exceptions.
• src/examples/exception_tracer.cpp : getting a bactrace via exceptions, posix style.

Benchmarks

• ecl_core_apps/src/benchmarks/exceptions.cpp : benchmarks the latencies for exception handling.

ChangeLog

Changes

• Feb 11 : Moved exception classes here from ecl_errors.

Bugs