Blame include/cppunit/TestAssert.h

Packit Service e31359
#ifndef CPPUNIT_TESTASSERT_H
Packit Service e31359
#define CPPUNIT_TESTASSERT_H
Packit Service e31359
Packit Service e31359
#include <cppunit/Portability.h>
Packit Service e31359
#include <cppunit/Exception.h>
Packit Service e31359
#include <cppunit/Asserter.h>
Packit Service e31359
#include <cppunit/portability/Stream.h>
Packit Service e31359
#include <cppunit/tools/StringHelper.h>
Packit Service e31359
#include <stdio.h>
Packit Service e31359
#include <float.h> // For struct assertion_traits<double>
Packit Service e31359
Packit Service e31359
// Work around "passing 'T' chooses 'int' over 'unsigned int'" warnings when T
Packit Service e31359
// is an enum type:
Packit Service e31359
#if defined __GNUC__ && (__GNUC__ < 4 || (__GNUC__ == 4 && __GNUC_MINOR__ < 6))
Packit Service e31359
#pragma GCC system_header
Packit Service e31359
#endif
Packit Service e31359
Packit Service e31359
Packit Service e31359
CPPUNIT_NS_BEGIN
Packit Service e31359
Packit Service e31359
/*! \brief Traits used by CPPUNIT_ASSERT* macros.
Packit Service e31359
 *
Packit Service e31359
 * Here is an example of specialising these traits: 
Packit Service e31359
 *
Packit Service e31359
 * \code
Packit Service e31359
 * template<>
Packit Service e31359
 * struct assertion_traits<std::string>   // specialization for the std::string type
Packit Service e31359
 * {
Packit Service e31359
 *   static bool equal( const std::string& x, const std::string& y )
Packit Service e31359
 *   {
Packit Service e31359
 *     return x == y;
Packit Service e31359
 *   }
Packit Service e31359
 *
Packit Service e31359
 *   static bool less( const std::string& x, const std::string& y )
Packit Service e31359
 *   {
Packit Service e31359
 *      return x < y;
Packit Service e31359
 *   }
Packit Service e31359
 *
Packit Service e31359
 *   static bool lessEqual( const std::string& x, const std::string& y )
Packit Service e31359
 *   {
Packit Service e31359
 *      return x <= y;
Packit Service e31359
 *   }
Packit Service e31359
 *
Packit Service e31359
 *   static std::string toString( const std::string& x )
Packit Service e31359
 *   {
Packit Service e31359
 *     std::string text = '"' + x + '"';    // adds quote around the string to see whitespace
Packit Service e31359
 *     OStringStream ost;
Packit Service e31359
 *     ost << text;
Packit Service e31359
 *     return ost.str();
Packit Service e31359
 *   }
Packit Service e31359
 * };
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
template <class T>
Packit Service e31359
struct assertion_traits 
Packit Service e31359
{  
Packit Service e31359
    static bool equal( const T& x, const T& y )
Packit Service e31359
    {
Packit Service e31359
        return x == y;
Packit Service e31359
    }
Packit Service e31359
Packit Service e31359
    static bool less( const T& x, const T& y )
Packit Service e31359
    {
Packit Service e31359
        return x < y;
Packit Service e31359
    }
Packit Service e31359
Packit Service e31359
    static bool lessEqual( const T& x, const T& y )
Packit Service e31359
    {
Packit Service e31359
        return x <= y;
Packit Service e31359
    }
Packit Service e31359
Packit Service e31359
    static std::string toString( const T& x )
Packit Service e31359
    {
Packit Service e31359
        return CPPUNIT_NS::StringHelper::toString(x);
Packit Service e31359
    }
Packit Service e31359
};
Packit Service e31359
Packit Service e31359
/*! \brief Traits used by CPPUNIT_ASSERT_DOUBLES_EQUAL(). 
Packit Service e31359
 * 
Packit Service e31359
 * This specialisation from @c struct @c assertion_traits<> ensures that 
Packit Service e31359
 * doubles are converted in full, instead of being rounded to the default 
Packit Service e31359
 * 6 digits of precision. Use the system defined ISO C99 macro DBL_DIG 
Packit Service e31359
 * within float.h is available to define the maximum precision, otherwise
Packit Service e31359
 * use the hard-coded maximum precision of 15.
Packit Service e31359
 */
Packit Service e31359
template <>
Packit Service e31359
struct assertion_traits<double>
Packit Service e31359
{  
Packit Service e31359
    static bool equal( double x, double y )
Packit Service e31359
    {
Packit Service e31359
        return x == y;
Packit Service e31359
    }
Packit Service e31359
Packit Service e31359
    static bool less( double x, double y )
Packit Service e31359
    {
Packit Service e31359
        return x < y;
Packit Service e31359
    }
Packit Service e31359
Packit Service e31359
    static bool lessEqual( double x, double y )
Packit Service e31359
    {
Packit Service e31359
        return x <= y;
Packit Service e31359
    }
Packit Service e31359
Packit Service e31359
    static std::string toString( double x )
Packit Service e31359
    {
Packit Service e31359
#ifdef DBL_DIG
Packit Service e31359
       const int precision = DBL_DIG;
Packit Service e31359
#else
Packit Service e31359
       const int precision = 15;
Packit Service e31359
#endif  // #ifdef DBL_DIG
Packit Service e31359
       char buffer[128];
Packit Service e31359
#ifdef __STDC_SECURE_LIB__ // Use secure version with visual studio 2005 to avoid warning.
Packit Service e31359
       sprintf_s(buffer, sizeof(buffer), "%.*g", precision, x); 
Packit Service e31359
#else	
Packit Service e31359
       sprintf(buffer, "%.*g", precision, x); 
Packit Service e31359
#endif
Packit Service e31359
       return buffer;
Packit Service e31359
    }
Packit Service e31359
};
Packit Service e31359
Packit Service e31359
Packit Service e31359
/*! \brief (Implementation) Asserts that two objects of the same type are equals.
Packit Service e31359
 * Use CPPUNIT_ASSERT_EQUAL instead of this function.
Packit Service e31359
 * \sa assertion_traits, Asserter::failNotEqual().
Packit Service e31359
 */
Packit Service e31359
template <class T>
Packit Service e31359
void assertEquals( const T& expected,
Packit Service e31359
                   const T& actual,
Packit Service e31359
                   SourceLine sourceLine,
Packit Service e31359
                   const std::string &message )
Packit Service e31359
{
Packit Service e31359
  if ( !assertion_traits<T>::equal(expected,actual) ) // lazy toString conversion...
Packit Service e31359
  {
Packit Service e31359
    Asserter::failNotEqual( assertion_traits<T>::toString(expected),
Packit Service e31359
                            assertion_traits<T>::toString(actual),
Packit Service e31359
                            sourceLine,
Packit Service e31359
                            message );
Packit Service e31359
  }
Packit Service e31359
}
Packit Service e31359
Packit Service e31359
Packit Service e31359
/*! \brief (Implementation) Asserts that two double are equals given a tolerance.
Packit Service e31359
 * Use CPPUNIT_ASSERT_DOUBLES_EQUAL instead of this function.
Packit Service e31359
 * \sa Asserter::failNotEqual().
Packit Service e31359
 * \sa CPPUNIT_ASSERT_DOUBLES_EQUAL for detailed semantic of the assertion.
Packit Service e31359
 */
Packit Service e31359
void CPPUNIT_API assertDoubleEquals( double expected,
Packit Service e31359
                                     double actual,
Packit Service e31359
                                     double delta,
Packit Service e31359
                                     SourceLine sourceLine, 
Packit Service e31359
                                     const std::string &message );
Packit Service e31359
Packit Service e31359
Packit Service e31359
/*! \brief (Implementation) Asserts that an object is less than another one of the same type
Packit Service e31359
 * Use CPPUNIT_ASSERT_LESS, CPPUNIT_ASSERT_GREATER instead of this function.
Packit Service e31359
 * \sa assertion_traits, Asserter::failNotLess().
Packit Service e31359
 */
Packit Service e31359
template <class T>
Packit Service e31359
void assertLess( const T& expected,
Packit Service e31359
                 const T& actual,
Packit Service e31359
                 SourceLine sourceLine,
Packit Service e31359
                 const std::string& message )
Packit Service e31359
{
Packit Service e31359
    if ( !assertion_traits<T>::less(actual,expected) )
Packit Service e31359
    {
Packit Service e31359
        Asserter::failNotLess( assertion_traits<T>::toString(expected),
Packit Service e31359
                               assertion_traits<T>::toString(actual),
Packit Service e31359
                               sourceLine,
Packit Service e31359
                               message );
Packit Service e31359
    }
Packit Service e31359
}
Packit Service e31359
Packit Service e31359
Packit Service e31359
/*! \brief (Implementation) Asserts that an object is less than another one of the same type
Packit Service e31359
 * Use CPPUNIT_ASSERT_LESS, CPPUNIT_ASSERT_GREATER instead of this function.
Packit Service e31359
 * \sa assertion_traits, Asserter::failNotLess().
Packit Service e31359
 */
Packit Service e31359
template <class T>
Packit Service e31359
void assertGreater( const T& expected,
Packit Service e31359
                 const T& actual,
Packit Service e31359
                 SourceLine sourceLine,
Packit Service e31359
                 const std::string& message )
Packit Service e31359
{
Packit Service e31359
    if ( !assertion_traits<T>::less(expected,actual) )
Packit Service e31359
    {
Packit Service e31359
        Asserter::failNotGreater( assertion_traits<T>::toString(expected),
Packit Service e31359
                               assertion_traits<T>::toString(actual),
Packit Service e31359
                               sourceLine,
Packit Service e31359
                               message );
Packit Service e31359
    }
Packit Service e31359
}
Packit Service e31359
Packit Service e31359
/*! \brief (Implementation) Asserts that two objects of the same type are equals.
Packit Service e31359
 * Use CPPUNIT_ASSERT_LESSEQUAL, CPPUNIT_ASSERT_GREATEREQUAL instead of this function.
Packit Service e31359
 * \sa assertion_traits, Asserter::failNotLessEqual().
Packit Service e31359
 */
Packit Service e31359
template <class T>
Packit Service e31359
void assertLessEqual( const T& expected,
Packit Service e31359
                      const T& actual,
Packit Service e31359
                      SourceLine sourceLine,
Packit Service e31359
                      const std::string& message )
Packit Service e31359
{
Packit Service e31359
    if ( !assertion_traits<T>::lessEqual(actual,expected) )
Packit Service e31359
    {
Packit Service e31359
        Asserter::failNotLessEqual( assertion_traits<T>::toString(expected),
Packit Service e31359
                               assertion_traits<T>::toString(actual),
Packit Service e31359
                               sourceLine,
Packit Service e31359
                               message );
Packit Service e31359
    }
Packit Service e31359
}
Packit Service e31359
Packit Service e31359
/*! \brief (Implementation) Asserts that two objects of the same type are equals.
Packit Service e31359
 * Use CPPUNIT_ASSERT_LESSEQUAL, CPPUNIT_ASSERT_GREATEREQUAL instead of this function.
Packit Service e31359
 * \sa assertion_traits, Asserter::failNotLessEqual().
Packit Service e31359
 */
Packit Service e31359
template <class T>
Packit Service e31359
void assertGreaterEqual( const T& expected,
Packit Service e31359
                      const T& actual,
Packit Service e31359
                      SourceLine sourceLine,
Packit Service e31359
                      const std::string& message )
Packit Service e31359
{
Packit Service e31359
    if ( !assertion_traits<T>::lessEqual(expected,actual) )
Packit Service e31359
    {
Packit Service e31359
        Asserter::failNotGreaterEqual( assertion_traits<T>::toString(expected),
Packit Service e31359
                               assertion_traits<T>::toString(actual),
Packit Service e31359
                               sourceLine,
Packit Service e31359
                               message );
Packit Service e31359
    }
Packit Service e31359
}
Packit Service e31359
/* A set of macros which allow us to get the line number
Packit Service e31359
 * and file name at the point of an error.
Packit Service e31359
 * Just goes to show that preprocessors do have some
Packit Service e31359
 * redeeming qualities.
Packit Service e31359
 */
Packit Service e31359
#if CPPUNIT_HAVE_CPP_SOURCE_ANNOTATION
Packit Service e31359
/** Assertions that a condition is \c true.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT(condition)                                                 \
Packit Service e31359
  ( CPPUNIT_NS::Asserter::failIf( !(condition),                                   \
Packit Service e31359
                                 CPPUNIT_NS::Message( "assertion failed",         \
Packit Service e31359
                                                      "Expression: " #condition), \
Packit Service e31359
                                 CPPUNIT_SOURCELINE() ) )
Packit Service e31359
#else
Packit Service e31359
#define CPPUNIT_ASSERT(condition)                                            \
Packit Service e31359
  ( CPPUNIT_NS::Asserter::failIf( !(condition),                              \
Packit Service e31359
                                  CPPUNIT_NS::Message( "assertion failed" ), \
Packit Service e31359
                                  CPPUNIT_SOURCELINE() ) )
Packit Service e31359
#endif
Packit Service e31359
Packit Service e31359
/** Assertion with a user specified message.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * \param message Message reported in diagnostic if \a condition evaluates
Packit Service e31359
 *                to \c false.
Packit Service e31359
 * \param condition If this condition evaluates to \c false then the
Packit Service e31359
 *                  test failed.
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_MESSAGE(message,condition)                          \
Packit Service e31359
  ( CPPUNIT_NS::Asserter::failIf( !(condition),                            \
Packit Service e31359
                                  CPPUNIT_NS::Message( "assertion failed", \
Packit Service e31359
                                                       "Expression: "      \
Packit Service e31359
                                                       #condition,         \
Packit Service e31359
                                                       message ),          \
Packit Service e31359
                                  CPPUNIT_SOURCELINE() ) )
Packit Service e31359
Packit Service e31359
/** Fails with the specified message.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * \param message Message reported in diagnostic.
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_FAIL( message )                                         \
Packit Service e31359
  ( CPPUNIT_NS::Asserter::fail( CPPUNIT_NS::Message( "forced failure",  \
Packit Service e31359
                                                     message ),         \
Packit Service e31359
                                CPPUNIT_SOURCELINE() ) )
Packit Service e31359
Packit Service e31359
#ifdef CPPUNIT_ENABLE_SOURCELINE_DEPRECATED
Packit Service e31359
/// Generalized macro for primitive value comparisons
Packit Service e31359
#define CPPUNIT_ASSERT_EQUAL(expected,actual)                     \
Packit Service e31359
  ( CPPUNIT_NS::assertEquals( (expected),             \
Packit Service e31359
                              (actual),               \
Packit Service e31359
                              __LINE__, __FILE__ ) )
Packit Service e31359
#else
Packit Service e31359
/** Asserts that two values are equals.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 *
Packit Service e31359
 * Equality and string representation can be defined with
Packit Service e31359
 * an appropriate CppUnit::assertion_traits class.
Packit Service e31359
 *
Packit Service e31359
 * A diagnostic is printed if actual and expected values disagree.
Packit Service e31359
 *
Packit Service e31359
 * Requirement for \a expected and \a actual parameters:
Packit Service e31359
 * - They are exactly of the same type
Packit Service e31359
 * - They are serializable into a std::strstream using operator <<.
Packit Service e31359
 * - They can be compared using operator ==. 
Packit Service e31359
 *
Packit Service e31359
 * The last two requirements (serialization and comparison) can be
Packit Service e31359
 * removed by specializing the CppUnit::assertion_traits.
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_EQUAL(expected,actual)          \
Packit Service e31359
  ( CPPUNIT_NS::assertEquals( (expected),              \
Packit Service e31359
                              (actual),                \
Packit Service e31359
                              CPPUNIT_SOURCELINE(),    \
Packit Service e31359
                              "" ) )
Packit Service e31359
Packit Service e31359
/** Asserts that two values are equals, provides additional message on failure.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 *
Packit Service e31359
 * Equality and string representation can be defined with
Packit Service e31359
 * an appropriate assertion_traits class.
Packit Service e31359
 *
Packit Service e31359
 * A diagnostic is printed if actual and expected values disagree.
Packit Service e31359
 * The message is printed in addition to the expected and actual value
Packit Service e31359
 * to provide additional information.
Packit Service e31359
 *
Packit Service e31359
 * Requirement for \a expected and \a actual parameters:
Packit Service e31359
 * - They are exactly of the same type
Packit Service e31359
 * - They are serializable into a std::strstream using operator <<.
Packit Service e31359
 * - They can be compared using operator ==. 
Packit Service e31359
 *
Packit Service e31359
 * The last two requirements (serialization and comparison) can be
Packit Service e31359
 * removed by specializing the CppUnit::assertion_traits.
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_EQUAL_MESSAGE(message,expected,actual)      \
Packit Service e31359
  ( CPPUNIT_NS::assertEquals( (expected),              \
Packit Service e31359
                              (actual),                \
Packit Service e31359
                              CPPUNIT_SOURCELINE(),    \
Packit Service e31359
                              (message) ) )
Packit Service e31359
#endif
Packit Service e31359
Packit Service e31359
/** Asserts that actual is less than expected, provides additional message on failure.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 *
Packit Service e31359
 * Less and string representation can be defined with
Packit Service e31359
 * an appropriate assertion_traits class.
Packit Service e31359
 *
Packit Service e31359
 * A diagnostic is printed if actual is less than expected.
Packit Service e31359
 * The message is printed in addition to the expected and actual value
Packit Service e31359
 * to provide additional information.
Packit Service e31359
 *
Packit Service e31359
 * Requirement for \a expected and \a actual parameters:
Packit Service e31359
 * - They are exactly of the same type
Packit Service e31359
 * - They are serializable into a std::strstream using operator <<.
Packit Service e31359
 * - They can be compared using operator <. 
Packit Service e31359
 *
Packit Service e31359
 * The last two requirements (serialization and comparison) can be
Packit Service e31359
 * removed by specializing the CppUnit::assertion_traits.
Packit Service e31359
 *
Packit Service e31359
 * \sa CPPUNIT_ASSERT_GREATER
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_LESS(expected, actual)          \
Packit Service e31359
    ( CPPUNIT_NS::assertLess( (expected),              \
Packit Service e31359
                              (actual),                \
Packit Service e31359
                              CPPUNIT_SOURCELINE(),    \
Packit Service e31359
                              "" ) )
Packit Service e31359
Packit Service e31359
/** Asserts that actual is greater than expected, provides additional message on failure.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 *
Packit Service e31359
 * String representation can be defined with
Packit Service e31359
 * an appropriate assertion_traits class. For comparison assertLess is used.
Packit Service e31359
 *
Packit Service e31359
 * A diagnostic is printed if actual is less than expected.
Packit Service e31359
 * The message is printed in addition to the expected and actual value
Packit Service e31359
 * to provide additional information.
Packit Service e31359
 *
Packit Service e31359
 * Requirement for \a expected and \a actual parameters:
Packit Service e31359
 * - They are exactly of the same type
Packit Service e31359
 * - They are serializable into a std::strstream using operator <<.
Packit Service e31359
 * - They can be compared using operator<. 
Packit Service e31359
 *
Packit Service e31359
 * The last two requirements (serialization and comparison) can be
Packit Service e31359
 * removed by specializing the CppUnit::assertion_traits.
Packit Service e31359
 *
Packit Service e31359
 * \sa CPPUNIT_ASSERT_LESS
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_GREATER(expected, actual)       \
Packit Service e31359
    ( CPPUNIT_NS::assertGreater( (expected),           \
Packit Service e31359
                                 (actual),             \
Packit Service e31359
                                 CPPUNIT_SOURCELINE(), \
Packit Service e31359
                                 "" ) )
Packit Service e31359
Packit Service e31359
/** Asserts that actual is less or equal than expected, provides additional message on failure.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 *
Packit Service e31359
 * LessEqual and string representation can be defined with
Packit Service e31359
 * an appropriate assertion_traits class.
Packit Service e31359
 *
Packit Service e31359
 * A diagnostic is printed if actual is greater than expected.
Packit Service e31359
 * The message is printed in addition to the expected and actual value
Packit Service e31359
 * to provide additional information.
Packit Service e31359
 *
Packit Service e31359
 * Requirement for \a expected and \a actual parameters:
Packit Service e31359
 * - They are exactly of the same type
Packit Service e31359
 * - They are serializable into a std::strstream using operator <<.
Packit Service e31359
 * - They can be compared using operator <=. 
Packit Service e31359
 *
Packit Service e31359
 * The last two requirements (serialization and comparison) can be
Packit Service e31359
 * removed by specializing the CppUnit::assertion_traits.
Packit Service e31359
 *
Packit Service e31359
 * \sa CPPUNIT_ASSERT_GREATEREQUAL
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_LESSEQUAL(expected, actual)               \
Packit Service e31359
    ( CPPUNIT_NS::assertLessEqual( (expected),              \
Packit Service e31359
                                   (actual),                \
Packit Service e31359
                                   CPPUNIT_SOURCELINE(),    \
Packit Service e31359
                                   "" ) )
Packit Service e31359
Packit Service e31359
/** Asserts that actual is greater than expected, provides additional message on failure.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 *
Packit Service e31359
 * String representation can be defined with
Packit Service e31359
 * an appropriate assertion_traits class. For comparison assertLess is used.
Packit Service e31359
 *
Packit Service e31359
 * A diagnostic is printed if actual is less than expected.
Packit Service e31359
 * The message is printed in addition to the expected and actual value
Packit Service e31359
 * to provide additional information.
Packit Service e31359
 *
Packit Service e31359
 * Requirement for \a expected and \a actual parameters:
Packit Service e31359
 * - They are exactly of the same type
Packit Service e31359
 * - They are serializable into a std::strstream using operator <<.
Packit Service e31359
 * - They can be compared using operator<=. 
Packit Service e31359
 *
Packit Service e31359
 * The last two requirements (serialization and comparison) can be
Packit Service e31359
 * removed by specializing the CppUnit::assertion_traits.
Packit Service e31359
 *
Packit Service e31359
 * \sa CPPUNIT_ASSERT_LESSEQUAL
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_GREATEREQUAL(expected, actual)            \
Packit Service e31359
    ( CPPUNIT_NS::assertGreaterEqual( (expected),                \
Packit Service e31359
                                      (actual),              \
Packit Service e31359
                                      CPPUNIT_SOURCELINE(),    \
Packit Service e31359
                                      "" ) )
Packit Service e31359
/*! \brief Macro for primitive double value comparisons. 
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 *
Packit Service e31359
 * The assertion pass if both expected and actual are finite and
Packit Service e31359
 * \c fabs( \c expected - \c actual ) <= \c delta.
Packit Service e31359
 * If either \c expected or actual are infinite (+/- inf), the 
Packit Service e31359
 * assertion pass if \c expected == \c actual.
Packit Service e31359
 * If either \c expected or \c actual is a NaN (not a number), then
Packit Service e31359
 * the assertion fails.
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_DOUBLES_EQUAL(expected,actual,delta)        \
Packit Service e31359
  ( CPPUNIT_NS::assertDoubleEquals( (expected),            \
Packit Service e31359
                                    (actual),              \
Packit Service e31359
                                    (delta),               \
Packit Service e31359
                                    CPPUNIT_SOURCELINE(),  \
Packit Service e31359
                                    "" ) )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/*! \brief Macro for primitive double value comparisons, setting a 
Packit Service e31359
 * user-supplied message in case of failure. 
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * \sa CPPUNIT_ASSERT_DOUBLES_EQUAL for detailed semantic of the assertion.
Packit Service e31359
 */
Packit Service e31359
#define CPPUNIT_ASSERT_DOUBLES_EQUAL_MESSAGE(message,expected,actual,delta)  \
Packit Service e31359
  ( CPPUNIT_NS::assertDoubleEquals( (expected),            \
Packit Service e31359
                                    (actual),              \
Packit Service e31359
                                    (delta),               \
Packit Service e31359
                                    CPPUNIT_SOURCELINE(),  \
Packit Service e31359
                                    (message) ) )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/** Asserts that the given expression throws an exception of the specified type. 
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   std::vector<int> v;
Packit Service e31359
 *  CPPUNIT_ASSERT_THROW( v.at( 50 ), std::out_of_range );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_THROW( expression, ExceptionType )              \
Packit Service e31359
   CPPUNIT_ASSERT_THROW_MESSAGE( CPPUNIT_NS::AdditionalMessage(),       \
Packit Service e31359
                                 expression,                            \
Packit Service e31359
                                 ExceptionType )
Packit Service e31359
Packit Service e31359
Packit Service e31359
// implementation detail
Packit Service e31359
#if defined(CPPUNIT_USE_TYPEINFO_NAME)
Packit Service e31359
#define CPPUNIT_EXTRACT_EXCEPTION_TYPE_( exception, no_rtti_message ) \
Packit Service e31359
   CPPUNIT_NS::TypeInfoHelper::getClassName( typeid(exception) )
Packit Service e31359
#else
Packit Service e31359
#define CPPUNIT_EXTRACT_EXCEPTION_TYPE_( exception, no_rtti_message ) \
Packit Service e31359
   std::string( no_rtti_message )
Packit Service e31359
#endif // CPPUNIT_USE_TYPEINFO_NAME
Packit Service e31359
Packit Service e31359
// implementation detail
Packit Service e31359
#define CPPUNIT_GET_PARAMETER_STRING( parameter ) #parameter
Packit Service e31359
Packit Service e31359
/** Asserts that the given expression throws an exception of the specified type, 
Packit Service e31359
 * setting a user supplied message in case of failure. 
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   std::vector<int> v;
Packit Service e31359
 *  CPPUNIT_ASSERT_THROW_MESSAGE( "- std::vector<int> v;", v.at( 50 ), std::out_of_range );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_THROW_MESSAGE( message, expression, ExceptionType )   \
Packit Service e31359
   do {                                                                       \
Packit Service e31359
      bool cpputCorrectExceptionThrown_ = false;                              \
Packit Service e31359
      CPPUNIT_NS::Message cpputMsg_( "expected exception not thrown" );       \
Packit Service e31359
      cpputMsg_.addDetail( message );                                         \
Packit Service e31359
      cpputMsg_.addDetail( "Expected: "                                       \
Packit Service e31359
                           CPPUNIT_GET_PARAMETER_STRING( ExceptionType ) );   \
Packit Service e31359
                                                                              \
Packit Service e31359
      try {                                                                   \
Packit Service e31359
         expression;                                                          \
Packit Service e31359
      } catch ( const ExceptionType & ) {                                     \
Packit Service e31359
         cpputCorrectExceptionThrown_ = true;                                 \
Packit Service e31359
      } catch ( const std::exception &e) {                                    \
Packit Service e31359
         cpputMsg_.addDetail( "Actual  : " +                                  \
Packit Service e31359
                              CPPUNIT_EXTRACT_EXCEPTION_TYPE_( e,             \
Packit Service e31359
                                          "std::exception or derived") );     \
Packit Service e31359
         cpputMsg_.addDetail( std::string("What()  : ") + e.what() );         \
Packit Service e31359
      } catch ( ... ) {                                                       \
Packit Service e31359
         cpputMsg_.addDetail( "Actual  : unknown.");                          \
Packit Service e31359
      }                                                                       \
Packit Service e31359
                                                                              \
Packit Service e31359
      if ( cpputCorrectExceptionThrown_ )                                     \
Packit Service e31359
         break;                                                               \
Packit Service e31359
                                                                              \
Packit Service e31359
      CPPUNIT_NS::Asserter::fail( cpputMsg_,                                  \
Packit Service e31359
                                  CPPUNIT_SOURCELINE() );                     \
Packit Service e31359
   } while ( false )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/** Asserts that the given expression does not throw any exceptions.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   std::vector<int> v;
Packit Service e31359
 *   v.push_back( 10 );
Packit Service e31359
 *  CPPUNIT_ASSERT_NO_THROW( v.at( 0 ) );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_NO_THROW( expression )                             \
Packit Service e31359
   CPPUNIT_ASSERT_NO_THROW_MESSAGE( CPPUNIT_NS::AdditionalMessage(),       \
Packit Service e31359
                                    expression )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/** Asserts that the given expression does not throw any exceptions, 
Packit Service e31359
 * setting a user supplied message in case of failure. 
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   std::vector<int> v;
Packit Service e31359
 *   v.push_back( 10 );
Packit Service e31359
 *  CPPUNIT_ASSERT_NO_THROW( "std::vector<int> v;", v.at( 0 ) );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_NO_THROW_MESSAGE( message, expression )               \
Packit Service e31359
   do {                                                                       \
Packit Service e31359
      CPPUNIT_NS::Message cpputMsg_( "unexpected exception caught" );         \
Packit Service e31359
      cpputMsg_.addDetail( message );                                         \
Packit Service e31359
                                                                              \
Packit Service e31359
      try {                                                                   \
Packit Service e31359
         expression;                                                          \
Packit Service e31359
      } catch ( const std::exception &e ) {                                   \
Packit Service e31359
         cpputMsg_.addDetail( "Caught: " +                                    \
Packit Service e31359
                              CPPUNIT_EXTRACT_EXCEPTION_TYPE_( e,             \
Packit Service e31359
                                          "std::exception or derived" ) );    \
Packit Service e31359
         cpputMsg_.addDetail( std::string("What(): ") + e.what() );           \
Packit Service e31359
         CPPUNIT_NS::Asserter::fail( cpputMsg_,                               \
Packit Service e31359
                                     CPPUNIT_SOURCELINE() );                  \
Packit Service e31359
      } catch ( ... ) {                                                       \
Packit Service e31359
         cpputMsg_.addDetail( "Caught: unknown." );                           \
Packit Service e31359
         CPPUNIT_NS::Asserter::fail( cpputMsg_,                               \
Packit Service e31359
                                     CPPUNIT_SOURCELINE() );                  \
Packit Service e31359
      }                                                                       \
Packit Service e31359
   } while ( false )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/** Asserts that an assertion fail.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Use to test assertions.
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   CPPUNIT_ASSERT_ASSERTION_FAIL( CPPUNIT_ASSERT( 1 == 2 ) );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_ASSERTION_FAIL( assertion )                 \
Packit Service e31359
   CPPUNIT_ASSERT_THROW( assertion, CPPUNIT_NS::Exception )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/** Asserts that an assertion fail, with a user-supplied message in 
Packit Service e31359
 * case of error.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Use to test assertions.
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   CPPUNIT_ASSERT_ASSERTION_FAIL_MESSAGE( "1 == 2", CPPUNIT_ASSERT( 1 == 2 ) );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_ASSERTION_FAIL_MESSAGE( message, assertion )    \
Packit Service e31359
   CPPUNIT_ASSERT_THROW_MESSAGE( message, assertion, CPPUNIT_NS::Exception )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/** Asserts that an assertion pass.
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Use to test assertions.
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   CPPUNIT_ASSERT_ASSERTION_PASS( CPPUNIT_ASSERT( 1 == 1 ) );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_ASSERTION_PASS( assertion )                 \
Packit Service e31359
   CPPUNIT_ASSERT_NO_THROW( assertion )
Packit Service e31359
Packit Service e31359
Packit Service e31359
/** Asserts that an assertion pass, with a user-supplied message in 
Packit Service e31359
 * case of failure. 
Packit Service e31359
 * \ingroup Assertions
Packit Service e31359
 * Use to test assertions.
Packit Service e31359
 * Example of usage:
Packit Service e31359
 * \code
Packit Service e31359
 *   CPPUNIT_ASSERT_ASSERTION_PASS_MESSAGE( "1 != 1", CPPUNIT_ASSERT( 1 == 1 ) );
Packit Service e31359
 * \endcode
Packit Service e31359
 */
Packit Service e31359
# define CPPUNIT_ASSERT_ASSERTION_PASS_MESSAGE( message, assertion )    \
Packit Service e31359
   CPPUNIT_ASSERT_NO_THROW_MESSAGE( message, assertion )
Packit Service e31359
Packit Service e31359
Packit Service e31359
Packit Service e31359
Packit Service e31359
// Backwards compatibility
Packit Service e31359
Packit Service e31359
#if CPPUNIT_ENABLE_NAKED_ASSERT
Packit Service e31359
Packit Service e31359
#undef assert
Packit Service e31359
#define assert(c)                 CPPUNIT_ASSERT(c)
Packit Service e31359
#define assertEqual(e,a)          CPPUNIT_ASSERT_EQUAL(e,a)
Packit Service e31359
#define assertDoublesEqual(e,a,d) CPPUNIT_ASSERT_DOUBLES_EQUAL(e,a,d)
Packit Service e31359
#define assertLongsEqual(e,a)     CPPUNIT_ASSERT_EQUAL(e,a)
Packit Service e31359
Packit Service e31359
#endif
Packit Service e31359
Packit Service e31359
Packit Service e31359
CPPUNIT_NS_END
Packit Service e31359
Packit Service e31359
#endif  // CPPUNIT_TESTASSERT_H