#include "internal/catch_suppress_warnings.h"
#include "internal/catch_platform.h"
#include "internal/catch_user_interfaces.h"
#include "internal/catch_tag_alias_autoregistrar.h"
#include "internal/catch_test_registry.h"
#include "internal/catch_capture.hpp"
#include "internal/catch_section.h"
#include "internal/catch_benchmark.h"
#include "internal/catch_interfaces_exception.h"
#include "internal/catch_approx.h"
#include "internal/catch_compiler_capabilities.h"
#include "internal/catch_string_manip.h"
#include "internal/catch_capture_matchers.h"
#include "internal/catch_generators.hpp"
#include "internal/catch_generators_generic.hpp"
#include "internal/catch_generators_specific.hpp"
#include "internal/catch_test_case_info.h"
#include "internal/catch_interfaces_runner.h"
#include "internal/catch_reenable_warnings.h"

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.

Macros
#define	CATCH_VERSION_MAJOR 2

#define	CATCH_VERSION_MINOR 7

#define	CATCH_VERSION_PATCH 2

#define	REQUIRE(...)

#define	REQUIRE_FALSE(...)

#define	REQUIRE_THROWS(...)

#define	REQUIRE_THROWS_AS(expr, exceptionType)

#define	REQUIRE_THROWS_WITH(expr, matcher)

#define	REQUIRE_THROWS_MATCHES(expr, exceptionType, matcher)

#define	REQUIRE_NOTHROW(...)

#define	CHECK(...)

#define	CHECK_FALSE(...)

#define	CHECKED_IF(...)

#define	CHECKED_ELSE(...)

#define	CHECK_NOFAIL(...)

#define	CHECK_THROWS(...)

#define	CHECK_THROWS_AS(expr, exceptionType)

#define	CHECK_THROWS_WITH(expr, matcher)

#define	CHECK_THROWS_MATCHES(expr, exceptionType, matcher)

#define	CHECK_NOTHROW(...)

#define	CHECK_THAT(arg, matcher)

#define	REQUIRE_THAT(arg, matcher)

#define	INFO(msg)

#define	UNSCOPED_INFO(msg)

#define	WARN(msg)

#define	CAPTURE(...)

#define	TEST_CASE(...)

#define	TEST_CASE_METHOD(className, ...)

#define	METHOD_AS_TEST_CASE(method, ...)

#define	REGISTER_TEST_CASE(Function, ...)

#define	SECTION(...)

#define	DYNAMIC_SECTION(...)

#define	FAIL(...)

#define	FAIL_CHECK(...)

#define	SUCCEED(...)

#define	ANON_TEST_CASE()

#define	TEMPLATE_TEST_CASE(...)

#define	TEMPLATE_TEST_CASE_METHOD(className, ...)

#define	TEMPLATE_PRODUCT_TEST_CASE(...)

#define	TEMPLATE_PRODUCT_TEST_CASE_METHOD(className, ...)

#define	STATIC_REQUIRE(...)

#define	STATIC_REQUIRE_FALSE(...)

#define	CATCH_TRANSLATE_EXCEPTION(signature)

#define	SCENARIO(...)

#define	SCENARIO_METHOD(className, ...)

#define	GIVEN(desc)

#define	AND_GIVEN(desc)

#define	WHEN(desc)

#define	AND_WHEN(desc)

#define	THEN(desc)

#define	AND_THEN(desc)

Macro Definition Documentation

◆ AND_GIVEN

#define AND_GIVEN ( desc )

Value:

INTERNAL_CATCH_DYNAMIC_SECTION( "And given: " << desc )

INTERNAL_CATCH_DYNAMIC_SECTION

#define INTERNAL_CATCH_DYNAMIC_SECTION(...)

Definition catch_section.h:44

Definition at line 263 of file catch.hpp.

◆ AND_THEN

#define AND_THEN ( desc )

Value:

INTERNAL_CATCH_DYNAMIC_SECTION( " And: " << desc )

Definition at line 267 of file catch.hpp.

◆ AND_WHEN

#define AND_WHEN ( desc )

Value:

INTERNAL_CATCH_DYNAMIC_SECTION( " And when: " << desc )

Definition at line 265 of file catch.hpp.

◆ ANON_TEST_CASE

#define ANON_TEST_CASE ( )

Value:

INTERNAL_CATCH_TESTCASE()

INTERNAL_CATCH_TESTCASE

#define INTERNAL_CATCH_TESTCASE(...)

Definition catch_test_registry.h:84

Definition at line 231 of file catch.hpp.

◆ CAPTURE

#define CAPTURE ( ... )

Value:

INTERNAL_CATCH_CAPTURE( INTERNAL_CATCH_UNIQUE_NAME(capturer), "CAPTURE",__VA_ARGS__ )

INTERNAL_CATCH_CAPTURE

#define INTERNAL_CATCH_CAPTURE(varName, macroName,...)

Definition catch_capture.hpp:125

INTERNAL_CATCH_UNIQUE_NAME

#define INTERNAL_CATCH_UNIQUE_NAME(name)

Definition catch_common.h:16

Definition at line 220 of file catch.hpp.

◆ CATCH_TRANSLATE_EXCEPTION

#define CATCH_TRANSLATE_EXCEPTION ( signature )

Value:

INTERNAL_CATCH_TRANSLATE_EXCEPTION( signature )

INTERNAL_CATCH_TRANSLATE_EXCEPTION

#define INTERNAL_CATCH_TRANSLATE_EXCEPTION(signature)

Definition catch_interfaces_exception.h:81

Definition at line 256 of file catch.hpp.

◆ CATCH_VERSION_MAJOR

#define CATCH_VERSION_MAJOR 2

Definition at line 12 of file catch.hpp.

◆ CATCH_VERSION_MINOR

#define CATCH_VERSION_MINOR 7

Definition at line 13 of file catch.hpp.

◆ CATCH_VERSION_PATCH

#define CATCH_VERSION_PATCH 2

Definition at line 14 of file catch.hpp.

◆ CHECK

#define CHECK ( ... )

Value:

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

INTERNAL_CATCH_TEST

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

Definition catch_capture.hpp:42

Catch::ResultDisposition::ContinueOnFailure

@ ContinueOnFailure

Definition catch_result_type.h:42

Definition at line 196 of file catch.hpp.

◆ CHECK_FALSE

#define CHECK_FALSE ( ... )

Value:

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

Catch::ResultDisposition::FalseTest

@ FalseTest

Definition catch_result_type.h:43

Definition at line 197 of file catch.hpp.

◆ CHECK_NOFAIL

#define CHECK_NOFAIL ( ... )

Value:

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

Catch::ResultDisposition::SuppressFail

@ SuppressFail

Definition catch_result_type.h:44

Definition at line 200 of file catch.hpp.

◆ CHECK_NOTHROW

#define CHECK_NOTHROW ( ... )

Value:

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

INTERNAL_CATCH_NO_THROW

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

Definition catch_capture.hpp:65

Definition at line 208 of file catch.hpp.

◆ CHECK_THAT

#define CHECK_THAT	(		arg,
			matcher )

Value:

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

INTERNAL_CHECK_THAT

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

Definition catch_capture_matchers.h:57

Definition at line 212 of file catch.hpp.

◆ CHECK_THROWS

#define CHECK_THROWS ( ... )

Value:

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

INTERNAL_CATCH_THROWS

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

Definition catch_capture.hpp:79

Definition at line 202 of file catch.hpp.

◆ CHECK_THROWS_AS

#define CHECK_THROWS_AS	(		expr,
			exceptionType )

Value:

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

INTERNAL_CATCH_THROWS_AS

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

Definition catch_capture.hpp:96

Definition at line 203 of file catch.hpp.

◆ CHECK_THROWS_MATCHES

#define CHECK_THROWS_MATCHES	(	expr,
		exceptionType,
		matcher )

Value:

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

INTERNAL_CATCH_THROWS_MATCHES

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

Definition catch_capture_matchers.h:68

Definition at line 206 of file catch.hpp.

◆ CHECK_THROWS_WITH

#define CHECK_THROWS_WITH	(		expr,
			matcher )

Value:

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

INTERNAL_CATCH_THROWS_STR_MATCHES

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

Definition catch_capture.hpp:139

Definition at line 204 of file catch.hpp.

◆ CHECKED_ELSE

#define CHECKED_ELSE ( ... )

Value:

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

INTERNAL_CATCH_ELSE

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

Definition catch_capture.hpp:60

Definition at line 199 of file catch.hpp.

◆ CHECKED_IF

#define CHECKED_IF ( ... )

Value:

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

INTERNAL_CATCH_IF

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

Definition catch_capture.hpp:55

Definition at line 198 of file catch.hpp.

◆ DYNAMIC_SECTION

#define DYNAMIC_SECTION ( ... )

Value:

INTERNAL_CATCH_DYNAMIC_SECTION( __VA_ARGS__ )

Definition at line 227 of file catch.hpp.

◆ FAIL

#define FAIL ( ... )

Value:

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

INTERNAL_CATCH_MSG

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

Definition catch_capture.hpp:117

Catch::ResultDisposition::Normal

@ Normal

Definition catch_result_type.h:40

Catch::ResultWas::ExplicitFailure

@ ExplicitFailure

Definition catch_result_type.h:23

Definition at line 228 of file catch.hpp.

◆ FAIL_CHECK

#define FAIL_CHECK ( ... )

Value:

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

Definition at line 229 of file catch.hpp.

◆ GIVEN

#define GIVEN ( desc )

Value:

INTERNAL_CATCH_DYNAMIC_SECTION( " Given: " << desc )

Definition at line 262 of file catch.hpp.

◆ INFO

#define INFO ( msg )

Value:

INTERNAL_CATCH_INFO( "INFO", msg )

INTERNAL_CATCH_INFO

#define INTERNAL_CATCH_INFO(macroName, log)

Definition catch_capture.hpp:130

Definition at line 217 of file catch.hpp.

◆ METHOD_AS_TEST_CASE

#define METHOD_AS_TEST_CASE	(		method,
			... )

Value:

INTERNAL_CATCH_METHOD_AS_TEST_CASE( method, __VA_ARGS__ )

INTERNAL_CATCH_METHOD_AS_TEST_CASE

#define INTERNAL_CATCH_METHOD_AS_TEST_CASE(QualifiedMethod,...)

Definition catch_test_registry.h:88

Definition at line 224 of file catch.hpp.

◆ REGISTER_TEST_CASE

#define REGISTER_TEST_CASE	(		Function,
			... )

Value:

INTERNAL_CATCH_REGISTER_TESTCASE( Function, __VA_ARGS__ )

INTERNAL_CATCH_REGISTER_TESTCASE

#define INTERNAL_CATCH_REGISTER_TESTCASE(Function,...)

Definition catch_test_registry.h:108

Definition at line 225 of file catch.hpp.

◆ REQUIRE

#define REQUIRE ( ... )

Value:

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

Definition at line 185 of file catch.hpp.

◆ REQUIRE_FALSE

#define REQUIRE_FALSE ( ... )

Value:

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

Definition at line 186 of file catch.hpp.

◆ REQUIRE_NOTHROW

#define REQUIRE_NOTHROW ( ... )

Value:

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

Definition at line 194 of file catch.hpp.

◆ REQUIRE_THAT

#define REQUIRE_THAT	(		arg,
			matcher )

Value:

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

Definition at line 214 of file catch.hpp.

◆ REQUIRE_THROWS

#define REQUIRE_THROWS ( ... )

Value:

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

Definition at line 188 of file catch.hpp.

◆ REQUIRE_THROWS_AS

#define REQUIRE_THROWS_AS	(		expr,
			exceptionType )

Value:

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

Definition at line 189 of file catch.hpp.

◆ REQUIRE_THROWS_MATCHES

#define REQUIRE_THROWS_MATCHES	(	expr,
		exceptionType,
		matcher )

Value:

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

Definition at line 192 of file catch.hpp.

◆ REQUIRE_THROWS_WITH

#define REQUIRE_THROWS_WITH	(		expr,
			matcher )

Value:

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

Definition at line 190 of file catch.hpp.

◆ SCENARIO

#define SCENARIO ( ... )

Value:

TEST_CASE( "Scenario: " __VA_ARGS__ )

TEST_CASE

#define TEST_CASE(...)

Definition catch.hpp:222

Definition at line 259 of file catch.hpp.

◆ SCENARIO_METHOD

#define SCENARIO_METHOD	(		className,
			... )

Value:

INTERNAL_CATCH_TEST_CASE_METHOD( className, "Scenario: " __VA_ARGS__ )

INTERNAL_CATCH_TEST_CASE_METHOD

#define INTERNAL_CATCH_TEST_CASE_METHOD(ClassName,...)

Definition catch_test_registry.h:104

Definition at line 260 of file catch.hpp.

◆ SECTION

#define SECTION ( ... )

Value:

INTERNAL_CATCH_SECTION( __VA_ARGS__ )

INTERNAL_CATCH_SECTION

#define INTERNAL_CATCH_SECTION(...)

Definition catch_section.h:39

Definition at line 226 of file catch.hpp.

◆ STATIC_REQUIRE

#define STATIC_REQUIRE ( ... )

Value:

static_assert( __VA_ARGS__, #__VA_ARGS__ ); SUCCEED( #__VA_ARGS__ )

SUCCEED

#define SUCCEED(...)

Definition catch.hpp:230

Definition at line 247 of file catch.hpp.

◆ STATIC_REQUIRE_FALSE

#define STATIC_REQUIRE_FALSE ( ... )

Value:

static_assert( !(__VA_ARGS__), "!(" #__VA_ARGS__ ")" ); SUCCEED( "!(" #__VA_ARGS__ ")" )

Definition at line 248 of file catch.hpp.

◆ SUCCEED

#define SUCCEED ( ... )

Value:

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

Catch::ResultWas::Ok

@ Ok

Definition catch_result_type.h:16

Definition at line 230 of file catch.hpp.

◆ TEMPLATE_PRODUCT_TEST_CASE

#define TEMPLATE_PRODUCT_TEST_CASE ( ... )

Value:

INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE( __VA_ARGS__ )

INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE

#define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE(Name, Tags,...)

Definition catch_test_registry.h:182

Definition at line 236 of file catch.hpp.

◆ TEMPLATE_PRODUCT_TEST_CASE_METHOD

#define TEMPLATE_PRODUCT_TEST_CASE_METHOD	(		className,
			... )

Value:

INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD( className, __VA_ARGS__ )

INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD

#define INTERNAL_CATCH_TEMPLATE_PRODUCT_TEST_CASE_METHOD(ClassName, Name, Tags,...)

Definition catch_test_registry.h:250

Definition at line 237 of file catch.hpp.

◆ TEMPLATE_TEST_CASE

#define TEMPLATE_TEST_CASE ( ... )

Value:

INTERNAL_CATCH_TEMPLATE_TEST_CASE( __VA_ARGS__ )

INTERNAL_CATCH_TEMPLATE_TEST_CASE

#define INTERNAL_CATCH_TEMPLATE_TEST_CASE(Name, Tags,...)

Definition catch_test_registry.h:141

Definition at line 234 of file catch.hpp.

◆ TEMPLATE_TEST_CASE_METHOD

#define TEMPLATE_TEST_CASE_METHOD	(		className,
			... )

Value:

INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD( className, __VA_ARGS__ )

INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD

#define INTERNAL_CATCH_TEMPLATE_TEST_CASE_METHOD(ClassName, Name, Tags,...)

Definition catch_test_registry.h:212

Definition at line 235 of file catch.hpp.

◆ TEST_CASE

#define TEST_CASE ( ... )

Value:

INTERNAL_CATCH_TESTCASE( __VA_ARGS__ )

Definition at line 222 of file catch.hpp.

◆ TEST_CASE_METHOD

#define TEST_CASE_METHOD	(		className,
			... )

Value:

INTERNAL_CATCH_TEST_CASE_METHOD( className, __VA_ARGS__ )

Definition at line 223 of file catch.hpp.

◆ THEN

#define THEN ( desc )

Value:

INTERNAL_CATCH_DYNAMIC_SECTION( " Then: " << desc )

Definition at line 266 of file catch.hpp.

◆ UNSCOPED_INFO

#define UNSCOPED_INFO ( msg )

Value:

INTERNAL_CATCH_UNSCOPED_INFO( "UNSCOPED_INFO", msg )

INTERNAL_CATCH_UNSCOPED_INFO

#define INTERNAL_CATCH_UNSCOPED_INFO(macroName, log)

Definition catch_capture.hpp:134

Definition at line 218 of file catch.hpp.

◆ WARN

#define WARN ( msg )

Value:

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

Catch::ResultWas::Warning

@ Warning

Definition catch_result_type.h:18

Definition at line 219 of file catch.hpp.

◆ WHEN

#define WHEN ( desc )

Value:

INTERNAL_CATCH_DYNAMIC_SECTION( " When: " << desc )

Definition at line 264 of file catch.hpp.

Macros

Macro Definition Documentation

◆ AND_GIVEN

◆ AND_THEN

◆ AND_WHEN

◆ ANON_TEST_CASE

◆ CAPTURE

◆ CATCH_TRANSLATE_EXCEPTION

◆ CATCH_VERSION_MAJOR

◆ CATCH_VERSION_MINOR

◆ CATCH_VERSION_PATCH

◆ CHECK

◆ CHECK_FALSE

◆ CHECK_NOFAIL

◆ CHECK_NOTHROW

◆ CHECK_THAT

◆ CHECK_THROWS

◆ CHECK_THROWS_AS

◆ CHECK_THROWS_MATCHES

◆ CHECK_THROWS_WITH

◆ CHECKED_ELSE

◆ CHECKED_IF

◆ DYNAMIC_SECTION

◆ FAIL

◆ FAIL_CHECK

◆ GIVEN

◆ INFO

◆ METHOD_AS_TEST_CASE

◆ REGISTER_TEST_CASE

◆ REQUIRE

◆ REQUIRE_FALSE

◆ REQUIRE_NOTHROW

◆ REQUIRE_THAT

◆ REQUIRE_THROWS

◆ REQUIRE_THROWS_AS

◆ REQUIRE_THROWS_MATCHES

◆ REQUIRE_THROWS_WITH

◆ SCENARIO

◆ SCENARIO_METHOD

◆ SECTION

◆ STATIC_REQUIRE

◆ STATIC_REQUIRE_FALSE

◆ SUCCEED

◆ TEMPLATE_PRODUCT_TEST_CASE

◆ TEMPLATE_PRODUCT_TEST_CASE_METHOD

◆ TEMPLATE_TEST_CASE

◆ TEMPLATE_TEST_CASE_METHOD

◆ TEST_CASE

◆ TEST_CASE_METHOD

◆ THEN

◆ UNSCOPED_INFO

◆ WARN

◆ WHEN