boost.png (6897 bytes) Home Libraries People FAQ More

PrevUpHomeNext

Macro BOOST_STACKTRACK_INFO

BOOST_STACKTRACK_INFO — create a dynamic information entry

Synopsis

#include <boost/stacktrack/info.hpp>

BOOST_STACKTRACK_INFO(purpose, stream_args)

Description

Useful for complex capturing complex data in infrequently encountered locations, such as initial startup configuration data and high level details for coarse-grained operations which are expensive on their own. BOOST_STACKTRACK_INFO is defined in boost/stacktrack/info.hpp instead of with the rest of the BOOST_STACTRACK_* macros in boost/stacktrack/stacktrack.hpp to avoid pulling in <sstream> unnecessarily.

Parameters

purpose
description of value to be included in trace
stream_args
ostream style output arg(s)

Notes: warning :Each time this is hit it creates a temporary string stream to "format" stream_args and convert it to an std::string. This is not a particularly efficient process. Excessive hits on this macro (for example, in tight loops or other frequent operations) will probably have an adverse impact on performance. It has nasty big pointy teeth - you have been warned.

Copyright © 2005 James Fowler

PrevUpHomeNext