catch.hpp File Reference

#include <iosfwd>
#include <string>
#include <cstdint>
#include <vector>
#include <memory>
#include <cstddef>
#include <type_traits>
#include <ostream>
#include <exception>
#include <stdexcept>
#include <cmath>
#include <functional>
#include <algorithm>

Include dependency graph for catch.hpp:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	Catch::CaseSensitive
class	Catch::NonCopyable
struct	Catch::SourceLineInfo
struct	Catch::StreamEndStop
struct	Catch::RegistrarForTagAliases
struct	Catch::ITestInvoker
struct	Catch::ITestCaseRegistry
class	Catch::StringRef
class	Catch::TestInvokerAsMethod< C >
struct	Catch::NameAndTags
struct	Catch::AutoReg
struct	Catch::ResultWas
struct	Catch::ResultDisposition
struct	Catch::AssertionInfo
struct	Catch::IStream
class	Catch::ReusableStringStream
struct	Catch_global_namespace_dummy
class	Catch::Detail::IsStreamInsertable< T >
struct	Catch::StringMaker< T, typename >
struct	Catch::StringMaker< std::string >
struct	Catch::StringMaker< std::wstring >
struct	Catch::StringMaker< char const * >
struct	Catch::StringMaker< char * >
struct	Catch::StringMaker< wchar_t const * >
struct	Catch::StringMaker< wchar_t * >
struct	Catch::StringMaker< char[SZ]>
struct	Catch::StringMaker< signed char[SZ]>
struct	Catch::StringMaker< unsigned char[SZ]>
struct	Catch::StringMaker< int >
struct	Catch::StringMaker< long >
struct	Catch::StringMaker< long long >
struct	Catch::StringMaker< unsigned int >
struct	Catch::StringMaker< unsigned long >
struct	Catch::StringMaker< unsigned long long >
struct	Catch::StringMaker< bool >
struct	Catch::StringMaker< char >
struct	Catch::StringMaker< signed char >
struct	Catch::StringMaker< unsigned char >
struct	Catch::StringMaker< std::nullptr_t >
struct	Catch::StringMaker< float >
struct	Catch::StringMaker< double >
struct	Catch::StringMaker< T * >
struct	Catch::StringMaker< R C::* >
struct	Catch::not_this_one
struct	Catch::is_range< T >
struct	Catch::StringMaker< R, typename std::enable_if< is_range< R >::value &&!::Catch::Detail::IsStreamInsertable< R >::value >::type >
struct	Catch::StringMaker< T[SZ]>
struct	Catch::ITransientExpression
class	Catch::BinaryExpr< LhsT, RhsT >
class	Catch::UnaryExpr< LhsT >
class	Catch::ExprLhs< LhsT >
struct	Catch::Decomposer
struct	Catch::IResultCapture
struct	Catch::TestFailureException
class	Catch::LazyExpression
struct	Catch::AssertionReaction
class	Catch::AssertionHandler
struct	Catch::MessageInfo
struct	Catch::MessageStream
struct	Catch::MessageBuilder
class	Catch::ScopedMessage
struct	Catch::Counts
struct	Catch::Totals
struct	Catch::SectionInfo
struct	Catch::SectionEndInfo
class	Catch::Timer
class	Catch::Section
class	Catch::BenchmarkLooper
struct	Catch::IRegistryHub
struct	Catch::IMutableRegistryHub
struct	Catch::IExceptionTranslator
struct	Catch::IExceptionTranslatorRegistry
class	Catch::ExceptionTranslatorRegistrar
class	Catch::Detail::Approx
struct	Catch::StringMaker< Catch::Detail::Approx >
struct	Catch::pluralise
struct	Catch::Matchers::Impl::MatchAllOf< ArgT >
struct	Catch::Matchers::Impl::MatchAnyOf< ArgT >
struct	Catch::Matchers::Impl::MatchNotOf< ArgT >
class	Catch::Matchers::Impl::MatcherUntypedBase
struct	Catch::Matchers::Impl::MatcherMethod< ObjectT >
struct	Catch::Matchers::Impl::MatcherMethod< PtrT * >
struct	Catch::Matchers::Impl::MatcherBase< T >
struct	Catch::Matchers::Impl::MatchAllOf< ArgT >
struct	Catch::Matchers::Impl::MatchAnyOf< ArgT >
struct	Catch::Matchers::Impl::MatchNotOf< ArgT >
struct	Catch::Matchers::Floating::WithinAbsMatcher
struct	Catch::Matchers::Floating::WithinUlpsMatcher
class	Catch::Matchers::Generic::PredicateMatcher< T >
struct	Catch::Matchers::StdString::CasedString
struct	Catch::Matchers::StdString::StringMatcherBase
struct	Catch::Matchers::StdString::EqualsMatcher
struct	Catch::Matchers::StdString::ContainsMatcher
struct	Catch::Matchers::StdString::StartsWithMatcher
struct	Catch::Matchers::StdString::EndsWithMatcher
struct	Catch::Matchers::StdString::RegexMatcher
struct	Catch::Matchers::Vector::ContainsElementMatcher< T >
struct	Catch::Matchers::Vector::ContainsMatcher< T >
struct	Catch::Matchers::Vector::EqualsMatcher< T >
struct	Catch::Matchers::Vector::UnorderedEqualsMatcher< T >
class	Catch::MatchExpr< ArgT, MatcherT >
struct	Catch::TestCaseInfo
class	Catch::TestCase
struct	Catch::IRunner

Namespaces
	Catch
	Catch::Detail
	Catch::Matchers
	Catch::Matchers::Impl
	Catch::Matchers::Floating
	Catch::Matchers::Generic
	Catch::Matchers::Generic::Detail
	Catch::Matchers::StdString
	Catch::Matchers::Vector
	Catch::Matchers::Vector::Detail

Macros
#define	CATCH_VERSION_MAJOR   2
#define	CATCH_VERSION_MINOR   2
#define	CATCH_VERSION_PATCH   2
#define	CATCH_INTERNAL_CONFIG_POSIX_SIGNALS
#define	CATCH_INTERNAL_CONFIG_COUNTER
#define	CATCH_CONFIG_COUNTER
#define	CATCH_CONFIG_POSIX_SIGNALS
#define	CATCH_CONFIG_WCHAR
#define	CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS
#define	CATCH_INTERNAL_UNSUPPRESS_PARENTHESES_WARNINGS
#define	CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS
#define	CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS
#define	INTERNAL_CATCH_UNIQUE_NAME_LINE2(name, line)   name##line
#define	INTERNAL_CATCH_UNIQUE_NAME_LINE(name, line)   INTERNAL_CATCH_UNIQUE_NAME_LINE2( name, line )
#define	INTERNAL_CATCH_UNIQUE_NAME(name)   INTERNAL_CATCH_UNIQUE_NAME_LINE( name, __COUNTER__ )
#define	CATCH_INTERNAL_LINEINFO   ::Catch::SourceLineInfo( __FILE__, static_cast<std::size_t>( __LINE__ ) )
#define	CATCH_REGISTER_TAG_ALIAS(alias, spec)
#define	INTERNAL_CATCH_TESTCASE2(TestName, ...)
#define	INTERNAL_CATCH_TESTCASE(...)   INTERNAL_CATCH_TESTCASE2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), __VA_ARGS__ )
#define	INTERNAL_CATCH_METHOD_AS_TEST_CASE(QualifiedMethod, ...)
#define	INTERNAL_CATCH_TEST_CASE_METHOD2(TestName, ClassName, ...)
#define	INTERNAL_CATCH_TEST_CASE_METHOD(ClassName, ...)   INTERNAL_CATCH_TEST_CASE_METHOD2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), ClassName, __VA_ARGS__ )
#define	INTERNAL_CATCH_REGISTER_TESTCASE(Function, ...)
#define	CATCH_INTERNAL_STRINGIFY(...)   #__VA_ARGS__
#define	INTERNAL_CATCH_TRY   try
#define	INTERNAL_CATCH_CATCH(handler)   catch(...) { handler.handleUnexpectedInflightException(); }
#define	INTERNAL_CATCH_REACT(handler)   handler.complete();
#define	INTERNAL_CATCH_TEST(macroName, resultDisposition, ...)
#define	INTERNAL_CATCH_IF(macroName, resultDisposition, ...)
#define	INTERNAL_CATCH_ELSE(macroName, resultDisposition, ...)
#define	INTERNAL_CATCH_NO_THROW(macroName, resultDisposition, ...)
#define	INTERNAL_CATCH_THROWS(macroName, resultDisposition, ...)
#define	INTERNAL_CATCH_THROWS_AS(macroName, exceptionType, resultDisposition, expr)
#define	INTERNAL_CATCH_MSG(macroName, messageType, resultDisposition, ...)
#define	INTERNAL_CATCH_INFO(macroName, log)   Catch::ScopedMessage INTERNAL_CATCH_UNIQUE_NAME( scopedMessage )( Catch::MessageBuilder( macroName, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info ) << log );
#define	INTERNAL_CATCH_THROWS_STR_MATCHES(macroName, resultDisposition, matcher, ...)
#define	INTERNAL_CATCH_SECTION(...)   if( Catch::Section const& INTERNAL_CATCH_UNIQUE_NAME( catch_internal_Section ) = Catch::SectionInfo( CATCH_INTERNAL_LINEINFO, __VA_ARGS__ ) )
#define	BENCHMARK(name)   for( Catch::BenchmarkLooper looper( name ); looper; looper.increment() )
#define	INTERNAL_CATCH_TRANSLATE_EXCEPTION2(translatorName, signature)
#define	INTERNAL_CATCH_TRANSLATE_EXCEPTION(signature)   INTERNAL_CATCH_TRANSLATE_EXCEPTION2( INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionTranslator ), signature )
#define	INTERNAL_CHECK_THAT(macroName, matcher, resultDisposition, arg)
#define	INTERNAL_CATCH_THROWS_MATCHES(macroName, exceptionType, resultDisposition, matcher, ...)
#define	REQUIRE(...)   INTERNAL_CATCH_TEST( "REQUIRE", Catch::ResultDisposition::Normal, __VA_ARGS__ )
#define	REQUIRE_FALSE(...)   INTERNAL_CATCH_TEST( "REQUIRE_FALSE", Catch::ResultDisposition::Normal | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )
#define	REQUIRE_THROWS(...)   INTERNAL_CATCH_THROWS( "REQUIRE_THROWS", Catch::ResultDisposition::Normal, __VA_ARGS__ )
#define	REQUIRE_THROWS_AS(expr, exceptionType)   INTERNAL_CATCH_THROWS_AS( "REQUIRE_THROWS_AS", exceptionType, Catch::ResultDisposition::Normal, expr )
#define	REQUIRE_THROWS_WITH(expr, matcher)   INTERNAL_CATCH_THROWS_STR_MATCHES( "REQUIRE_THROWS_WITH", Catch::ResultDisposition::Normal, matcher, expr )
#define	REQUIRE_THROWS_MATCHES(expr, exceptionType, matcher)   INTERNAL_CATCH_THROWS_MATCHES( "REQUIRE_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::Normal, matcher, expr )
#define	REQUIRE_NOTHROW(...)   INTERNAL_CATCH_NO_THROW( "REQUIRE_NOTHROW", Catch::ResultDisposition::Normal, __VA_ARGS__ )
#define	CHECK(...)   INTERNAL_CATCH_TEST( "CHECK", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
#define	CHECK_FALSE(...)   INTERNAL_CATCH_TEST( "CHECK_FALSE", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )
#define	CHECKED_IF(...)   INTERNAL_CATCH_IF( "CHECKED_IF", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
#define	CHECKED_ELSE(...)   INTERNAL_CATCH_ELSE( "CHECKED_ELSE", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
#define	CHECK_NOFAIL(...)   INTERNAL_CATCH_TEST( "CHECK_NOFAIL", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::SuppressFail, __VA_ARGS__ )
#define	CHECK_THROWS(...)   INTERNAL_CATCH_THROWS( "CHECK_THROWS", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
#define	CHECK_THROWS_AS(expr, exceptionType)   INTERNAL_CATCH_THROWS_AS( "CHECK_THROWS_AS", exceptionType, Catch::ResultDisposition::ContinueOnFailure, expr )
#define	CHECK_THROWS_WITH(expr, matcher)   INTERNAL_CATCH_THROWS_STR_MATCHES( "CHECK_THROWS_WITH", Catch::ResultDisposition::ContinueOnFailure, matcher, expr )
#define	CHECK_THROWS_MATCHES(expr, exceptionType, matcher)   INTERNAL_CATCH_THROWS_MATCHES( "CHECK_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::ContinueOnFailure, matcher, expr )
#define	CHECK_NOTHROW(...)   INTERNAL_CATCH_NO_THROW( "CHECK_NOTHROW", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
#define	CHECK_THAT(arg, matcher)   INTERNAL_CHECK_THAT( "CHECK_THAT", matcher, Catch::ResultDisposition::ContinueOnFailure, arg )
#define	REQUIRE_THAT(arg, matcher)   INTERNAL_CHECK_THAT( "REQUIRE_THAT", matcher, Catch::ResultDisposition::Normal, arg )
#define	INFO(msg)   INTERNAL_CATCH_INFO( "INFO", msg )
#define	WARN(msg)   INTERNAL_CATCH_MSG( "WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )
#define	CAPTURE(msg)   INTERNAL_CATCH_INFO( "CAPTURE", #msg " := " << ::Catch::Detail::stringify(msg) )
#define	TEST_CASE(...)   INTERNAL_CATCH_TESTCASE( __VA_ARGS__ )
#define	TEST_CASE_METHOD(className, ...)   INTERNAL_CATCH_TEST_CASE_METHOD( className, __VA_ARGS__ )
#define	METHOD_AS_TEST_CASE(method, ...)   INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, __VA_ARGS__ )
#define	REGISTER_TEST_CASE(Function, ...)   INTERNAL_CATCH_REGISTER_TESTCASE( Function, __VA_ARGS__ )
#define	SECTION(...)   INTERNAL_CATCH_SECTION( __VA_ARGS__ )
#define	FAIL(...)   INTERNAL_CATCH_MSG( "FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )
#define	FAIL_CHECK(...)   INTERNAL_CATCH_MSG( "FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
#define	SUCCEED(...)   INTERNAL_CATCH_MSG( "SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
#define	ANON_TEST_CASE()   INTERNAL_CATCH_TESTCASE()
#define	CATCH_TRANSLATE_EXCEPTION(signature)   INTERNAL_CATCH_TRANSLATE_EXCEPTION( signature )
#define	SCENARIO(...)   TEST_CASE( "Scenario: " __VA_ARGS__ )
#define	SCENARIO_METHOD(className, ...)   INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " __VA_ARGS__ )
#define	GIVEN(desc)   SECTION( std::string(" Given: ") + desc )
#define	WHEN(desc)   SECTION( std::string(" When: ") + desc )
#define	AND_WHEN(desc)   SECTION( std::string("And when: ") + desc )
#define	THEN(desc)   SECTION( std::string(" Then: ") + desc )
#define	AND_THEN(desc)   SECTION( std::string(" And: ") + desc )

Typedefs
using	Catch::ITestCasePtr = std::shared_ptr< ITestInvoker >
using	Catch::IReporterFactoryPtr = std::shared_ptr< IReporterFactory >
using	Catch::exceptionTranslateFunction) = std::string(*)(
using	Catch::ExceptionTranslators = std::vector< std::unique_ptr< IExceptionTranslator const >>
using	Catch::StringMatcher = Matchers::Impl::MatcherBase< std::string >

Functions
unsigned int	Catch::rngSeed ()
std::ostream &	Catch::operator<< (std::ostream &os, SourceLineInfo const &info)
template<typename T >
T const &	Catch::operator+ (T const &value, StreamEndStop)
bool	Catch::matchTest (TestCase const &testCase, TestSpec const &testSpec, IConfig const &config)
std::vector< TestCase >	Catch::filterTests (std::vector< TestCase > const &testCases, TestSpec const &testSpec, IConfig const &config)
std::vector< TestCase > const &	Catch::getAllTestCasesSorted (IConfig const &config)
auto	Catch::operator+ (StringRef const &lhs, StringRef const &rhs) -> std::string
auto	Catch::operator+ (StringRef const &lhs, char const *rhs) -> std::string
auto	Catch::operator+ (char const *lhs, StringRef const &rhs) -> std::string
auto	Catch::operator+= (std::string &lhs, StringRef const &sr) -> std::string &
auto	Catch::operator<< (std::ostream &os, StringRef const &sr) -> std::ostream &
auto	Catch::operator""_sr (char const *rawChars, std::size_t size) noexcept-> StringRef
auto	Catch::makeTestInvoker (void(*testAsFunction)()) noexcept-> ITestInvoker *
template<typename C >
auto	Catch::makeTestInvoker (void(C::*testAsMethod)()) noexcept-> ITestInvoker *
bool	Catch::isOk (ResultWas::OfType resultType)
bool	Catch::isJustInfo (int flags)
ResultDisposition::Flags	Catch::operator| (ResultDisposition::Flags lhs, ResultDisposition::Flags rhs)
bool	Catch::shouldContinueOnFailure (int flags)
bool	Catch::isFalseTest (int flags)
bool	Catch::shouldSuppressFailure (int flags)
std::ostream &	Catch::cout ()
std::ostream &	Catch::cerr ()
std::ostream &	Catch::clog ()
auto	Catch::makeStream (StringRef const &filename) -> IStream const *
std::ostream &	operator<< (std::ostream &, Catch_global_namespace_dummy)
std::string	Catch::Detail::rawMemoryToString (const void *object, std::size_t size)
template<typename T >
std::string	Catch::Detail::rawMemoryToString (const T &object)
template<typename E >
std::string	Catch::Detail::convertUnknownEnumToString (E e)
template<typename T >
std::enable_if<!std::is_enum< T >::value, std::string >::type	Catch::Detail::convertUnstreamable (T const &value)
template<typename T >
std::enable_if< std::is_enum< T >::value, std::string >::type	Catch::Detail::convertUnstreamable (T const &value)
template<typename T >
std::string	Catch::Detail::stringify (const T &e)
template<typename InputIterator >
std::string	Catch::Detail::rangeToString (InputIterator first, InputIterator last)
template<typename Range >
std::string	Catch::rangeToString (Range const &range)
template<typename Allocator >
std::string	Catch::rangeToString (std::vector< bool, Allocator > const &v)
void	Catch::formatReconstructedExpression (std::ostream &os, std::string const &lhs, StringRef op, std::string const &rhs)
template<typename LhsT , typename RhsT >
auto	Catch::compareEqual (LhsT const &lhs, RhsT const &rhs) -> bool
template<typename T >
auto	Catch::compareEqual (T *const &lhs, int rhs) -> bool
template<typename T >
auto	Catch::compareEqual (T *const &lhs, long rhs) -> bool
template<typename T >
auto	Catch::compareEqual (int lhs, T *const &rhs) -> bool
template<typename T >
auto	Catch::compareEqual (long lhs, T *const &rhs) -> bool
template<typename LhsT , typename RhsT >
auto	Catch::compareNotEqual (LhsT const &lhs, RhsT &&rhs) -> bool
template<typename T >
auto	Catch::compareNotEqual (T *const &lhs, int rhs) -> bool
template<typename T >
auto	Catch::compareNotEqual (T *const &lhs, long rhs) -> bool
template<typename T >
auto	Catch::compareNotEqual (int lhs, T *const &rhs) -> bool
template<typename T >
auto	Catch::compareNotEqual (long lhs, T *const &rhs) -> bool
void	Catch::handleExpression (ITransientExpression const &expr)
template<typename T >
void	Catch::handleExpression (ExprLhs< T > const &expr)
IResultCapture &	Catch::getResultCapture ()
void	Catch::handleExceptionMatchExpr (AssertionHandler &handler, std::string const &str, StringRef matcherString)
auto	Catch::getCurrentNanosecondsSinceEpoch () -> uint64_t
auto	Catch::getEstimatedClockResolution () -> uint64_t
IRegistryHub &	Catch::getRegistryHub ()
IMutableRegistryHub &	Catch::getMutableRegistryHub ()
void	Catch::cleanUp ()
std::string	Catch::translateActiveException ()
bool	Catch::startsWith (std::string const &s, std::string const &prefix)
bool	Catch::startsWith (std::string const &s, char prefix)
bool	Catch::endsWith (std::string const &s, std::string const &suffix)
bool	Catch::endsWith (std::string const &s, char suffix)
bool	Catch::contains (std::string const &s, std::string const &infix)
void	Catch::toLowerInPlace (std::string &s)
std::string	Catch::toLower (std::string const &s)
std::string	Catch::trim (std::string const &str)
bool	Catch::replaceInPlace (std::string &str, std::string const &replaceThis, std::string const &withThis)
Floating::WithinUlpsMatcher	Catch::Matchers::WithinULP (double target, int maxUlpDiff)
Floating::WithinUlpsMatcher	Catch::Matchers::WithinULP (float target, int maxUlpDiff)
Floating::WithinAbsMatcher	Catch::Matchers::WithinAbs (double target, double margin)
std::string	Catch::Matchers::Generic::Detail::finalizeDescription (const std::string &desc)
template<typename T >
Generic::PredicateMatcher< T >	Catch::Matchers::Predicate (std::function< bool(T const &)> const &predicate, std::string const &description="")
StdString::EqualsMatcher	Catch::Matchers::Equals (std::string const &str, CaseSensitive::Choice caseSensitivity=CaseSensitive::Yes)
StdString::ContainsMatcher	Catch::Matchers::Contains (std::string const &str, CaseSensitive::Choice caseSensitivity=CaseSensitive::Yes)
StdString::EndsWithMatcher	Catch::Matchers::EndsWith (std::string const &str, CaseSensitive::Choice caseSensitivity=CaseSensitive::Yes)
StdString::StartsWithMatcher	Catch::Matchers::StartsWith (std::string const &str, CaseSensitive::Choice caseSensitivity=CaseSensitive::Yes)
StdString::RegexMatcher	Catch::Matchers::Matches (std::string const &regex, CaseSensitive::Choice caseSensitivity=CaseSensitive::Yes)
template<typename InputIterator , typename T >
size_t	Catch::Matchers::Vector::Detail::count (InputIterator first, InputIterator last, T const &item)
template<typename InputIterator , typename T >
bool	Catch::Matchers::Vector::Detail::contains (InputIterator first, InputIterator last, T const &item)
template<typename T >
Vector::ContainsMatcher< T >	Catch::Matchers::Contains (std::vector< T > const &comparator)
template<typename T >
Vector::ContainsElementMatcher< T >	Catch::Matchers::VectorContains (T const &comparator)
template<typename T >
Vector::EqualsMatcher< T >	Catch::Matchers::Equals (std::vector< T > const &comparator)
template<typename T >
Vector::UnorderedEqualsMatcher< T >	Catch::Matchers::UnorderedEquals (std::vector< T > const &target)
void	Catch::handleExceptionMatchExpr (AssertionHandler &handler, StringMatcher const &matcher, StringRef matcherString)
template<typename ArgT , typename MatcherT >
auto	Catch::makeMatchExpr (ArgT const &arg, MatcherT const &matcher, StringRef matcherString) -> MatchExpr< ArgT, MatcherT >
TestCase	Catch::makeTestCase (ITestInvoker *testCase, std::string const &className, NameAndTags const &nameAndTags, SourceLineInfo const &lineInfo)

Variables
const std::string	Catch::Detail::unprintableString
not_this_one	Catch::begin (...)
not_this_one	Catch::end (...)

Macro Definition Documentation

#define AND_THEN

(

desc

)

SECTION( std::string(" And: ") + desc )

#define AND_WHEN

(

desc

)

SECTION( std::string("And when: ") + desc )

#define ANON_TEST_CASE

(

)

INTERNAL_CATCH_TESTCASE()

#define BENCHMARK

(

name

)

for( Catch::BenchmarkLooper looper( name ); looper; looper.increment() )

#define CAPTURE

(

msg

)

INTERNAL_CATCH_INFO( "CAPTURE", #msg " := " << ::Catch::Detail::stringify(msg) )

#define CATCH_CONFIG_COUNTER

#define CATCH_CONFIG_POSIX_SIGNALS

#define CATCH_CONFIG_WCHAR

#define CATCH_INTERNAL_CONFIG_COUNTER

#define CATCH_INTERNAL_CONFIG_POSIX_SIGNALS

#define CATCH_INTERNAL_LINEINFO   ::Catch::SourceLineInfo( __FILE__, static_cast<std::size_t>( __LINE__ ) )

#define CATCH_INTERNAL_STRINGIFY

(

...

)

#__VA_ARGS__

#define CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS

#define CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS

#define CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS

#define CATCH_INTERNAL_UNSUPPRESS_PARENTHESES_WARNINGS

#define CATCH_REGISTER_TAG_ALIAS	(		alias,
			spec
	)

Value:

CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
    namespace{ Catch::RegistrarForTagAliases INTERNAL_CATCH_UNIQUE_NAME( AutoRegisterTagAlias )( alias, spec, CATCH_INTERNAL_LINEINFO ); } \
    CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS

#define CATCH_TRANSLATE_EXCEPTION

(

signature

)

INTERNAL_CATCH_TRANSLATE_EXCEPTION( signature )

#define CATCH_VERSION_MAJOR   2

#define CATCH_VERSION_MINOR   2

#define CATCH_VERSION_PATCH   2

#define CHECK

(

...

)

INTERNAL_CATCH_TEST( "CHECK", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )

#define CHECK_FALSE

(

...

)

INTERNAL_CATCH_TEST( "CHECK_FALSE", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )

#define CHECK_NOFAIL

(

...

)

INTERNAL_CATCH_TEST( "CHECK_NOFAIL", Catch::ResultDisposition::ContinueOnFailure | Catch::ResultDisposition::SuppressFail, __VA_ARGS__ )

#define CHECK_NOTHROW

(

...

)

INTERNAL_CATCH_NO_THROW( "CHECK_NOTHROW", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )

#define CHECK_THAT	(		arg,
			matcher
	)		INTERNAL_CHECK_THAT( "CHECK_THAT", matcher, Catch::ResultDisposition::ContinueOnFailure, arg )

#define CHECK_THROWS

(

...

)

INTERNAL_CATCH_THROWS( "CHECK_THROWS", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )

#define CHECK_THROWS_AS	(		expr,
			exceptionType
	)		INTERNAL_CATCH_THROWS_AS( "CHECK_THROWS_AS", exceptionType, Catch::ResultDisposition::ContinueOnFailure, expr )

#define CHECK_THROWS_MATCHES	(		expr,
			exceptionType,
			matcher
	)		INTERNAL_CATCH_THROWS_MATCHES( "CHECK_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::ContinueOnFailure, matcher, expr )

#define CHECK_THROWS_WITH	(		expr,
			matcher
	)		INTERNAL_CATCH_THROWS_STR_MATCHES( "CHECK_THROWS_WITH", Catch::ResultDisposition::ContinueOnFailure, matcher, expr )

#define CHECKED_ELSE

(

...

)

INTERNAL_CATCH_ELSE( "CHECKED_ELSE", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )

#define CHECKED_IF

(

...

)

INTERNAL_CATCH_IF( "CHECKED_IF", Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )

#define FAIL

(

...

)

INTERNAL_CATCH_MSG( "FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )

#define FAIL_CHECK

(

...

)

INTERNAL_CATCH_MSG( "FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )

#define GIVEN

(

desc

)

SECTION( std::string(" Given: ") + desc )

#define INFO

(

msg

)

INTERNAL_CATCH_INFO( "INFO", msg )

#define INTERNAL_CATCH_CATCH

(

handler

)

catch(...) { handler.handleUnexpectedInflightException(); }

#define INTERNAL_CATCH_ELSE	(		macroName,
			resultDisposition,
			...
	)

Value:

INTERNAL_CATCH_TEST( macroName, resultDisposition, __VA_ARGS__ ); \
    if( !Catch::getResultCapture().lastAssertionPassed() )

#define INTERNAL_CATCH_IF	(		macroName,
			resultDisposition,
			...
	)

Value:

INTERNAL_CATCH_TEST( macroName, resultDisposition, __VA_ARGS__ ); \
    if( Catch::getResultCapture().lastAssertionPassed() )

#define INTERNAL_CATCH_INFO	(		macroName,
			log
	)		Catch::ScopedMessage INTERNAL_CATCH_UNIQUE_NAME( scopedMessage )( Catch::MessageBuilder( macroName, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info ) << log );

#define INTERNAL_CATCH_METHOD_AS_TEST_CASE	(		QualifiedMethod,
			...
	)

Value:

CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
        namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( Catch::makeTestInvoker( &QualifiedMethod ), CATCH_INTERNAL_LINEINFO, "&" #QualifiedMethod, Catch::NameAndTags{ __VA_ARGS__ } ); } /* NOLINT */ \
        CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS

#define INTERNAL_CATCH_MSG	(		macroName,
			messageType,
			resultDisposition,
			...
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, "", resultDisposition ); \
        catchAssertionHandler.handleMessage( messageType, ( Catch::MessageStream() << __VA_ARGS__ + ::Catch::StreamEndStop() ).m_stream.str() ); \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( false )

#define INTERNAL_CATCH_NO_THROW	(		macroName,
			resultDisposition,
			...
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__), resultDisposition ); \
        try { \
            static_cast<void>(__VA_ARGS__); \
            catchAssertionHandler.handleExceptionNotThrownAsExpected(); \
        } \
        catch( ... ) { \
            catchAssertionHandler.handleUnexpectedInflightException(); \
        } \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( false )

#define INTERNAL_CATCH_REACT

(

handler

)

handler.complete();

#define INTERNAL_CATCH_REGISTER_TESTCASE	(		Function,
			...
	)

Value:

CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
        Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( Catch::makeTestInvoker( Function ), CATCH_INTERNAL_LINEINFO, "", Catch::NameAndTags{ __VA_ARGS__ } ); /* NOLINT */ \
        CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS

#define INTERNAL_CATCH_SECTION

(

...

)

if( Catch::Section const& INTERNAL_CATCH_UNIQUE_NAME( catch_internal_Section ) = Catch::SectionInfo( CATCH_INTERNAL_LINEINFO, __VA_ARGS__ ) )

#define INTERNAL_CATCH_TEST	(		macroName,
			resultDisposition,
			...
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__), resultDisposition ); \
        INTERNAL_CATCH_TRY { \
            CATCH_INTERNAL_SUPPRESS_PARENTHESES_WARNINGS \
            catchAssertionHandler.handleExpr( Catch::Decomposer() <= __VA_ARGS__ ); \
            CATCH_INTERNAL_UNSUPPRESS_PARENTHESES_WARNINGS \
        } INTERNAL_CATCH_CATCH( catchAssertionHandler ) \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( (void)0, false && static_cast<bool>( !!(__VA_ARGS__) ) )

#define INTERNAL_CATCH_TEST_CASE_METHOD	(		ClassName,
			...
	)		INTERNAL_CATCH_TEST_CASE_METHOD2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), ClassName, __VA_ARGS__ )

#define INTERNAL_CATCH_TEST_CASE_METHOD2	(		TestName,
			ClassName,
			...
	)

Value:

CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
        namespace{ \
            struct TestName : ClassName{ \
                void test(); \
            }; \
            Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar ) ( Catch::makeTestInvoker( &TestName::test ), CATCH_INTERNAL_LINEINFO, #ClassName, Catch::NameAndTags{ __VA_ARGS__ } ); /* NOLINT */ \
        } \
        CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS \
        void TestName::test()

#define INTERNAL_CATCH_TESTCASE

(

...

)

INTERNAL_CATCH_TESTCASE2( INTERNAL_CATCH_UNIQUE_NAME( ____C_A_T_C_H____T_E_S_T____ ), __VA_ARGS__ )

#define INTERNAL_CATCH_TESTCASE2	(		TestName,
			...
	)

Value:

static void TestName(); \
        CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
        namespace{ Catch::AutoReg INTERNAL_CATCH_UNIQUE_NAME( autoRegistrar )( Catch::makeTestInvoker( &TestName ), CATCH_INTERNAL_LINEINFO, "", Catch::NameAndTags{ __VA_ARGS__ } ); } /* NOLINT */ \
        CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS \
        static void TestName()

#define INTERNAL_CATCH_THROWS	(		macroName,
			resultDisposition,
			...
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__), resultDisposition); \
        if( catchAssertionHandler.allowThrows() ) \
            try { \
                static_cast<void>(__VA_ARGS__); \
                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
            } \
            catch( ... ) { \
                catchAssertionHandler.handleExceptionThrownAsExpected(); \
            } \
        else \
            catchAssertionHandler.handleThrowingCallSkipped(); \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( false )

#define INTERNAL_CATCH_THROWS_AS	(		macroName,
			exceptionType,
			resultDisposition,
			expr
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(expr) ", " CATCH_INTERNAL_STRINGIFY(exceptionType), resultDisposition ); \
        if( catchAssertionHandler.allowThrows() ) \
            try { \
                static_cast<void>(expr); \
                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
            } \
            catch( exceptionType const& ) { \
                catchAssertionHandler.handleExceptionThrownAsExpected(); \
            } \
            catch( ... ) { \
                catchAssertionHandler.handleUnexpectedInflightException(); \
            } \
        else \
            catchAssertionHandler.handleThrowingCallSkipped(); \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( false )

#define INTERNAL_CATCH_THROWS_MATCHES	(		macroName,
			exceptionType,
			resultDisposition,
			matcher,
			...
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__) ", " CATCH_INTERNAL_STRINGIFY(exceptionType) ", " CATCH_INTERNAL_STRINGIFY(matcher), resultDisposition ); \
        if( catchAssertionHandler.allowThrows() ) \
            try { \
                static_cast<void>(__VA_ARGS__ ); \
                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
            } \
            catch( exceptionType const& ex ) { \
                catchAssertionHandler.handleExpr( Catch::makeMatchExpr( ex, matcher, #matcher ) ); \
            } \
            catch( ... ) { \
                catchAssertionHandler.handleUnexpectedInflightException(); \
            } \
        else \
            catchAssertionHandler.handleThrowingCallSkipped(); \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( false )

#define INTERNAL_CATCH_THROWS_STR_MATCHES	(		macroName,
			resultDisposition,
			matcher,
			...
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(__VA_ARGS__) ", " CATCH_INTERNAL_STRINGIFY(matcher), resultDisposition ); \
        if( catchAssertionHandler.allowThrows() ) \
            try { \
                static_cast<void>(__VA_ARGS__); \
                catchAssertionHandler.handleUnexpectedExceptionNotThrown(); \
            } \
            catch( ... ) { \
                Catch::handleExceptionMatchExpr( catchAssertionHandler, matcher, #matcher ); \
            } \
        else \
            catchAssertionHandler.handleThrowingCallSkipped(); \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( false )

#define INTERNAL_CATCH_TRANSLATE_EXCEPTION

(

signature

)

INTERNAL_CATCH_TRANSLATE_EXCEPTION2( INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionTranslator ), signature )

#define INTERNAL_CATCH_TRANSLATE_EXCEPTION2	(		translatorName,
			signature
	)

Value:

static std::string translatorName( signature ); \
    CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS \
    namespace{ Catch::ExceptionTranslatorRegistrar INTERNAL_CATCH_UNIQUE_NAME( catch_internal_ExceptionRegistrar )( &translatorName ); } \
    CATCH_INTERNAL_UNSUPPRESS_GLOBALS_WARNINGS \
    static std::string translatorName( signature )

#define INTERNAL_CATCH_TRY   try

#define INTERNAL_CATCH_UNIQUE_NAME

(

name

)

INTERNAL_CATCH_UNIQUE_NAME_LINE( name, __COUNTER__ )

#define INTERNAL_CATCH_UNIQUE_NAME_LINE	(		name,
			line
	)		INTERNAL_CATCH_UNIQUE_NAME_LINE2( name, line )

#define INTERNAL_CATCH_UNIQUE_NAME_LINE2	(		name,
			line
	)		name##line

#define INTERNAL_CHECK_THAT	(		macroName,
			matcher,
			resultDisposition,
			arg
	)

Value:

do { \
        Catch::AssertionHandler catchAssertionHandler( macroName, CATCH_INTERNAL_LINEINFO, CATCH_INTERNAL_STRINGIFY(arg) ", " CATCH_INTERNAL_STRINGIFY(matcher), resultDisposition ); \
        INTERNAL_CATCH_TRY { \
            catchAssertionHandler.handleExpr( Catch::makeMatchExpr( arg, matcher, #matcher ) ); \
        } INTERNAL_CATCH_CATCH( catchAssertionHandler ) \
        INTERNAL_CATCH_REACT( catchAssertionHandler ) \
    } while( false )

#define METHOD_AS_TEST_CASE	(		method,
			...
	)		INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, __VA_ARGS__ )

#define REGISTER_TEST_CASE	(		Function,
			...
	)		INTERNAL_CATCH_REGISTER_TESTCASE( Function, __VA_ARGS__ )

#define REQUIRE

(

...

)

INTERNAL_CATCH_TEST( "REQUIRE", Catch::ResultDisposition::Normal, __VA_ARGS__ )

#define REQUIRE_FALSE

(

...

)

INTERNAL_CATCH_TEST( "REQUIRE_FALSE", Catch::ResultDisposition::Normal | Catch::ResultDisposition::FalseTest, __VA_ARGS__ )

#define REQUIRE_NOTHROW

(

...

)

INTERNAL_CATCH_NO_THROW( "REQUIRE_NOTHROW", Catch::ResultDisposition::Normal, __VA_ARGS__ )

#define REQUIRE_THAT	(		arg,
			matcher
	)		INTERNAL_CHECK_THAT( "REQUIRE_THAT", matcher, Catch::ResultDisposition::Normal, arg )

#define REQUIRE_THROWS

(

...

)

INTERNAL_CATCH_THROWS( "REQUIRE_THROWS", Catch::ResultDisposition::Normal, __VA_ARGS__ )

#define REQUIRE_THROWS_AS	(		expr,
			exceptionType
	)		INTERNAL_CATCH_THROWS_AS( "REQUIRE_THROWS_AS", exceptionType, Catch::ResultDisposition::Normal, expr )

#define REQUIRE_THROWS_MATCHES	(		expr,
			exceptionType,
			matcher
	)		INTERNAL_CATCH_THROWS_MATCHES( "REQUIRE_THROWS_MATCHES", exceptionType, Catch::ResultDisposition::Normal, matcher, expr )

#define REQUIRE_THROWS_WITH	(		expr,
			matcher
	)		INTERNAL_CATCH_THROWS_STR_MATCHES( "REQUIRE_THROWS_WITH", Catch::ResultDisposition::Normal, matcher, expr )

#define SCENARIO

(

...

)

TEST_CASE( "Scenario: " __VA_ARGS__ )

#define SCENARIO_METHOD	(		className,
			...
	)		INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " __VA_ARGS__ )

#define SECTION

(

...

)

INTERNAL_CATCH_SECTION( __VA_ARGS__ )

#define SUCCEED

(

...

)

INTERNAL_CATCH_MSG( "SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )

#define TEST_CASE

(

...

)

INTERNAL_CATCH_TESTCASE( __VA_ARGS__ )

#define TEST_CASE_METHOD	(		className,
			...
	)		INTERNAL_CATCH_TEST_CASE_METHOD( className, __VA_ARGS__ )

#define THEN

(

desc

)

SECTION( std::string(" Then: ") + desc )

#define WARN

(

msg

)

INTERNAL_CATCH_MSG( "WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )

#define WHEN

(

desc

)

SECTION( std::string(" When: ") + desc )

Function Documentation

std::ostream& operator<<	(	std::ostream &	,
		Catch_global_namespace_dummy
	)