Index: assert.html =================================================================== --- assert.html (revision 76706) +++ assert.html (working copy) @@ -37,8 +37,14 @@
If the macro BOOST_ENABLE_ASSERT_HANDLER is defined when <boost/assert.hpp> is included, BOOST_ASSERT(expr) evaluates expr and, if the result is false, evaluates the expression
+ BOOST_ASSERT_CURRENT_FUNCTION_NAME defines the macro, used to get current function name.
+ It defaults to BOOST_CURRENT_FUNCTION.
+ BOOST_CURRENT_FUNCTION
can produce very long names, that may lead to huge size of output files.
+ Users may define BOOST_ASSERT_CURRENT_FUNCTION_NAME before including <boost/assert.hpp>
+ to specify a different current function macro (for example to shorter but not portable __FUNCTION__ macro or to
+ "(unknown)" value).
-::boost::assertion_failed(#expr, BOOST_CURRENT_FUNCTION, +
::boost::assertion_failed(#expr, BOOST_ASSERT_CURRENT_FUNCTION_NAME, __FILE__, __LINE__)
assertion_failed is declared in <boost/assert.hpp>
@@ -68,10 +74,16 @@
defined or expr
evaluates to true
. If those
macros and BOOST_ENABLE_ASSERT_HANDLER are not
defined, and expr
evaluates to false
, an error
- message that includes #expr, msg, BOOST_CURRENT_FUNCTION,
+ message that includes #expr, msg, BOOST_ASSERT_MSG_CURRENT_FUNCTION_NAME ,
__FILE__, and __LINE__ is sent to output stream
BOOST_ASSERT_MSG_OSTREAM
and std::abort()
is called.
BOOST_ASSERT_MSG_CURRENT_FUNCTION_NAME defines the macro, used to get current function name.
+ It defaults to BOOST_CURRENT_FUNCTION.
+ BOOST_CURRENT_FUNCTION
can produce very long names, that may lead to huge size of output files.
+ Users may define BOOST_ASSERT_MSG_CURRENT_FUNCTION_NAME before including <boost/assert.hpp>
+ to specify a different current function macro (for example to shorter but not portable __FUNCTION__ macro or to
+ "(unknown)" value).
BOOST_ASSERT_MSG_OSTREAM defines the output stream. It defaults to std::cerr
.
Integrated development environments (IDE's) like Microsoft Visual Studio
may produce easier to understand output if messages go to a different
@@ -81,7 +93,7 @@
is included, instead of sending a error message to an output
stream, this expression is evaluated
-::boost::assertion_failed_msg(#expr, msg, BOOST_CURRENT_FUNCTION, +
::boost::assertion_failed_msg(#expr, msg, BOOST_ASSERT_MSG_CURRENT_FUNCTION_NAME, __FILE__, __LINE__)
assertion_failed_msg is declared in <boost/assert.hpp>