gtest.h File Reference

#include <limits>
#include <ostream>
#include <vector>
#include "gtest/internal/gtest-internal.h"
#include "gtest/internal/gtest-string.h"
#include "gtest/gtest-death-test.h"
#include "gtest/gtest-message.h"
#include "gtest/gtest-param-test.h"
#include "gtest/gtest-printers.h"
#include "gtest/gtest_prod.h"
#include "gtest/gtest-test-part.h"
#include "gtest/gtest-typed-test.h"
#include "gtest/gtest_pred_impl.h"

Include dependency graph for gtest.h:

Go to the source code of this file.

Classes
class	testing::AssertionResult
class	testing::Test
class	testing::TestProperty
class	testing::TestResult
class	testing::TestInfo
class	testing::TestCase
class	testing::Environment
class	testing::TestEventListener
class	testing::EmptyTestEventListener
class	testing::TestEventListeners
class	testing::UnitTest
class	testing::internal::EqHelper< lhs_is_null_literal >
class	testing::internal::EqHelper< true >
class	testing::internal::AssertHelper

Namespaces
	testing
	testing::internal

Macros
#define	GTEST_IMPL_CMP_HELPER_(op_name, op)
#define	ADD_FAILURE()   GTEST_NONFATAL_FAILURE_("Failed")
#define	ADD_FAILURE_AT(file, line)
#define	GTEST_FAIL()   GTEST_FATAL_FAILURE_("Failed")
#define	FAIL()   GTEST_FAIL()
#define	GTEST_SUCCEED()   GTEST_SUCCESS_("Succeeded")
#define	SUCCEED()   GTEST_SUCCEED()
#define	EXPECT_THROW(statement, expected_exception)   GTEST_TEST_THROW_(statement, expected_exception, GTEST_NONFATAL_FAILURE_)
#define	EXPECT_NO_THROW(statement)   GTEST_TEST_NO_THROW_(statement, GTEST_NONFATAL_FAILURE_)
#define	EXPECT_ANY_THROW(statement)   GTEST_TEST_ANY_THROW_(statement, GTEST_NONFATAL_FAILURE_)
#define	ASSERT_THROW(statement, expected_exception)   GTEST_TEST_THROW_(statement, expected_exception, GTEST_FATAL_FAILURE_)
#define	ASSERT_NO_THROW(statement)   GTEST_TEST_NO_THROW_(statement, GTEST_FATAL_FAILURE_)
#define	ASSERT_ANY_THROW(statement)   GTEST_TEST_ANY_THROW_(statement, GTEST_FATAL_FAILURE_)
#define	EXPECT_TRUE(condition)
#define	EXPECT_FALSE(condition)
#define	ASSERT_TRUE(condition)
#define	ASSERT_FALSE(condition)
#define	EXPECT_EQ(val1, val2)
#define	EXPECT_NE(val1, val2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)
#define	EXPECT_LE(val1, val2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)
#define	EXPECT_LT(val1, val2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)
#define	EXPECT_GE(val1, val2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)
#define	EXPECT_GT(val1, val2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)
#define	GTEST_ASSERT_EQ(val1, val2)
#define	GTEST_ASSERT_NE(val1, val2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)
#define	GTEST_ASSERT_LE(val1, val2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)
#define	GTEST_ASSERT_LT(val1, val2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)
#define	GTEST_ASSERT_GE(val1, val2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)
#define	GTEST_ASSERT_GT(val1, val2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)
#define	ASSERT_EQ(val1, val2)   GTEST_ASSERT_EQ(val1, val2)
#define	ASSERT_NE(val1, val2)   GTEST_ASSERT_NE(val1, val2)
#define	ASSERT_LE(val1, val2)   GTEST_ASSERT_LE(val1, val2)
#define	ASSERT_LT(val1, val2)   GTEST_ASSERT_LT(val1, val2)
#define	ASSERT_GE(val1, val2)   GTEST_ASSERT_GE(val1, val2)
#define	ASSERT_GT(val1, val2)   GTEST_ASSERT_GT(val1, val2)
#define	EXPECT_STREQ(s1, s2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)
#define	EXPECT_STRNE(s1, s2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)
#define	EXPECT_STRCASEEQ(s1, s2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)
#define	EXPECT_STRCASENE(s1, s2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)
#define	ASSERT_STREQ(s1, s2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)
#define	ASSERT_STRNE(s1, s2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)
#define	ASSERT_STRCASEEQ(s1, s2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)
#define	ASSERT_STRCASENE(s1, s2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)
#define	EXPECT_FLOAT_EQ(val1, val2)
#define	EXPECT_DOUBLE_EQ(val1, val2)
#define	ASSERT_FLOAT_EQ(val1, val2)
#define	ASSERT_DOUBLE_EQ(val1, val2)
#define	EXPECT_NEAR(val1, val2, abs_error)
#define	ASSERT_NEAR(val1, val2, abs_error)
#define	ASSERT_NO_FATAL_FAILURE(statement)   GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_FATAL_FAILURE_)
#define	EXPECT_NO_FATAL_FAILURE(statement)   GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_NONFATAL_FAILURE_)
#define	SCOPED_TRACE(message)
#define	GTEST_TEST(test_case_name, test_name)
#define	TEST(test_case_name, test_name)   GTEST_TEST(test_case_name, test_name)
#define	TEST_F(test_fixture, test_name)

Typedefs
typedef internal::TimeInMillis	testing::TimeInMillis

Functions
	testing::GTEST_DECLARE_bool_ (also_run_disabled_tests)
	testing::GTEST_DECLARE_bool_ (break_on_failure)
	testing::GTEST_DECLARE_bool_ (catch_exceptions)
	testing::GTEST_DECLARE_string_ (color)
	testing::GTEST_DECLARE_string_ (filter)
	testing::GTEST_DECLARE_bool_ (list_tests)
	testing::GTEST_DECLARE_string_ (output)
	testing::GTEST_DECLARE_bool_ (print_time)
	testing::GTEST_DECLARE_int32_ (random_seed)
	testing::GTEST_DECLARE_int32_ (repeat)
	testing::GTEST_DECLARE_bool_ (show_internal_stack_frames)
	testing::GTEST_DECLARE_bool_ (shuffle)
	testing::GTEST_DECLARE_int32_ (stack_trace_depth)
	testing::GTEST_DECLARE_bool_ (throw_on_failure)
	testing::GTEST_DECLARE_string_ (stream_result_to)
class UnitTestImpl *	testing::internal::GetUnitTestImpl ()
void	testing::internal::ReportFailureInUnknownLocation (TestPartResult::Type result_type, const std::string &message)
GTEST_API_ AssertionResult	testing::AssertionSuccess ()
GTEST_API_ AssertionResult	testing::AssertionFailure ()
GTEST_API_ AssertionResult	testing::AssertionFailure (const Message &msg)
Environment *	testing::AddGlobalTestEnvironment (Environment *env)
GTEST_API_ void	testing::InitGoogleTest (int *argc, char **argv)
GTEST_API_ void	testing::InitGoogleTest (int *argc, wchar_t **argv)
template<typename T1 , typename T2 >
AssertionResult	testing::internal::CmpHelperEQFailure (const char *lhs_expression, const char *rhs_expression, const T1 &lhs, const T2 &rhs)
template<typename T1 , typename T2 >
AssertionResult	testing::internal::CmpHelperEQ (const char *lhs_expression, const char *rhs_expression, const T1 &lhs, const T2 &rhs)
GTEST_API_ AssertionResult	testing::internal::CmpHelperEQ (const char *lhs_expression, const char *rhs_expression, BiggestInt lhs, BiggestInt rhs)
template<typename T1 , typename T2 >
AssertionResult	testing::internal::CmpHelperOpFailure (const char *expr1, const char *expr2, const T1 &val1, const T2 &val2, const char *op)
	testing::internal::GTEST_IMPL_CMP_HELPER_ (NE, !=)
	testing::internal::GTEST_IMPL_CMP_HELPER_ (LE,<=)
	testing::internal::GTEST_IMPL_CMP_HELPER_ (LT,<)
	testing::internal::GTEST_IMPL_CMP_HELPER_ (GE, >=)
	testing::internal::GTEST_IMPL_CMP_HELPER_ (GT, >)
GTEST_API_ AssertionResult	testing::internal::CmpHelperSTREQ (const char *s1_expression, const char *s2_expression, const char *s1, const char *s2)
GTEST_API_ AssertionResult	testing::internal::CmpHelperSTRCASEEQ (const char *s1_expression, const char *s2_expression, const char *s1, const char *s2)
GTEST_API_ AssertionResult	testing::internal::CmpHelperSTRNE (const char *s1_expression, const char *s2_expression, const char *s1, const char *s2)
GTEST_API_ AssertionResult	testing::internal::CmpHelperSTRCASENE (const char *s1_expression, const char *s2_expression, const char *s1, const char *s2)
GTEST_API_ AssertionResult	testing::internal::CmpHelperSTREQ (const char *s1_expression, const char *s2_expression, const wchar_t *s1, const wchar_t *s2)
GTEST_API_ AssertionResult	testing::internal::CmpHelperSTRNE (const char *s1_expression, const char *s2_expression, const wchar_t *s1, const wchar_t *s2)
GTEST_API_ AssertionResult	testing::IsSubstring (const char *needle_expr, const char *haystack_expr, const char *needle, const char *haystack)
GTEST_API_ AssertionResult	testing::IsSubstring (const char *needle_expr, const char *haystack_expr, const wchar_t *needle, const wchar_t *haystack)
GTEST_API_ AssertionResult	testing::IsNotSubstring (const char *needle_expr, const char *haystack_expr, const char *needle, const char *haystack)
GTEST_API_ AssertionResult	testing::IsNotSubstring (const char *needle_expr, const char *haystack_expr, const wchar_t *needle, const wchar_t *haystack)
GTEST_API_ AssertionResult	testing::IsSubstring (const char *needle_expr, const char *haystack_expr, const ::std::string &needle, const ::std::string &haystack)
GTEST_API_ AssertionResult	testing::IsNotSubstring (const char *needle_expr, const char *haystack_expr, const ::std::string &needle, const ::std::string &haystack)
template<typename RawType >
AssertionResult	testing::internal::CmpHelperFloatingPointEQ (const char *lhs_expression, const char *rhs_expression, RawType lhs_value, RawType rhs_value)
GTEST_API_ AssertionResult	testing::internal::DoubleNearPredFormat (const char *expr1, const char *expr2, const char *abs_error_expr, double val1, double val2, double abs_error)
GTEST_API_ AssertionResult	testing::FloatLE (const char *expr1, const char *expr2, float val1, float val2)
GTEST_API_ AssertionResult	testing::DoubleLE (const char *expr1, const char *expr2, double val1, double val2)
template<typename T1 , typename T2 >
bool	testing::StaticAssertTypeEq ()
int	RUN_ALL_TESTS () GTEST_MUST_USE_RESULT_

Variables
const int	testing::kMaxStackTraceDepth = 100

Macro Definition Documentation

ADD_FAILURE

#define ADD_FAILURE

(

)

GTEST_NONFATAL_FAILURE_("Failed")

ADD_FAILURE_AT

#define ADD_FAILURE_AT	(		file,
			line
	)

Value:

GTEST_MESSAGE_AT_(file, line, "Failed", \
                    ::testing::TestPartResult::kNonFatalFailure)

ASSERT_ANY_THROW

#define ASSERT_ANY_THROW

(

statement

)

GTEST_TEST_ANY_THROW_(statement, GTEST_FATAL_FAILURE_)

ASSERT_DOUBLE_EQ

#define ASSERT_DOUBLE_EQ	(		val1,
			val2
	)

Value:

ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \
                      val1, val2)

ASSERT_EQ

#define ASSERT_EQ	(		val1,
			val2
	)		GTEST_ASSERT_EQ(val1, val2)

ASSERT_FALSE

#define ASSERT_FALSE

(

condition

)

Value:

GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \
                      GTEST_FATAL_FAILURE_)

ASSERT_FLOAT_EQ

#define ASSERT_FLOAT_EQ	(		val1,
			val2
	)

Value:

ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \
                      val1, val2)

ASSERT_GE

#define ASSERT_GE	(		val1,
			val2
	)		GTEST_ASSERT_GE(val1, val2)

ASSERT_GT

#define ASSERT_GT	(		val1,
			val2
	)		GTEST_ASSERT_GT(val1, val2)

ASSERT_LE

#define ASSERT_LE	(		val1,
			val2
	)		GTEST_ASSERT_LE(val1, val2)

ASSERT_LT

#define ASSERT_LT	(		val1,
			val2
	)		GTEST_ASSERT_LT(val1, val2)

ASSERT_NE

#define ASSERT_NE	(		val1,
			val2
	)		GTEST_ASSERT_NE(val1, val2)

ASSERT_NEAR

#define ASSERT_NEAR	(		val1,
			val2,
			abs_error
	)

Value:

ASSERT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \
                      val1, val2, abs_error)

ASSERT_NO_FATAL_FAILURE

#define ASSERT_NO_FATAL_FAILURE

(

statement

)

GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_FATAL_FAILURE_)

ASSERT_NO_THROW

#define ASSERT_NO_THROW

(

statement

)

GTEST_TEST_NO_THROW_(statement, GTEST_FATAL_FAILURE_)

ASSERT_STRCASEEQ

#define ASSERT_STRCASEEQ	(		s1,
			s2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)

ASSERT_STRCASENE

#define ASSERT_STRCASENE	(		s1,
			s2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)

ASSERT_STREQ

#define ASSERT_STREQ	(		s1,
			s2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)

ASSERT_STRNE

#define ASSERT_STRNE	(		s1,
			s2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)

ASSERT_THROW

#define ASSERT_THROW	(		statement,
			expected_exception
	)		GTEST_TEST_THROW_(statement, expected_exception, GTEST_FATAL_FAILURE_)

ASSERT_TRUE

#define ASSERT_TRUE

(

condition

)

Value:

GTEST_TEST_BOOLEAN_((condition), #condition, false, true, \
                      GTEST_FATAL_FAILURE_)

EXPECT_ANY_THROW

#define EXPECT_ANY_THROW

(

statement

)

GTEST_TEST_ANY_THROW_(statement, GTEST_NONFATAL_FAILURE_)

EXPECT_DOUBLE_EQ

#define EXPECT_DOUBLE_EQ	(		val1,
			val2
	)

Value:

EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \
                      val1, val2)

EXPECT_EQ

#define EXPECT_EQ	(		val1,
			val2
	)

Value:

EXPECT_PRED_FORMAT2(::testing::internal:: \
                      EqHelper<GTEST_IS_NULL_LITERAL_(val1)>::Compare, \
                      val1, val2)

EXPECT_FALSE

#define EXPECT_FALSE

(

condition

)

Value:

GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \
                      GTEST_NONFATAL_FAILURE_)

EXPECT_FLOAT_EQ

#define EXPECT_FLOAT_EQ	(		val1,
			val2
	)

Value:

EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \
                      val1, val2)

EXPECT_GE

#define EXPECT_GE	(		val1,
			val2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)

EXPECT_GT

#define EXPECT_GT	(		val1,
			val2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)

EXPECT_LE

#define EXPECT_LE	(		val1,
			val2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)

EXPECT_LT

#define EXPECT_LT	(		val1,
			val2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)

EXPECT_NE

#define EXPECT_NE	(		val1,
			val2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)

EXPECT_NEAR

#define EXPECT_NEAR	(		val1,
			val2,
			abs_error
	)

Value:

EXPECT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \
                      val1, val2, abs_error)

EXPECT_NO_FATAL_FAILURE

#define EXPECT_NO_FATAL_FAILURE

(

statement

)

GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_NONFATAL_FAILURE_)

EXPECT_NO_THROW

#define EXPECT_NO_THROW

(

statement

)

GTEST_TEST_NO_THROW_(statement, GTEST_NONFATAL_FAILURE_)

EXPECT_STRCASEEQ

#define EXPECT_STRCASEEQ	(		s1,
			s2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)

EXPECT_STRCASENE

#define EXPECT_STRCASENE	(		s1,
			s2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)

EXPECT_STREQ

#define EXPECT_STREQ	(		s1,
			s2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)

EXPECT_STRNE

#define EXPECT_STRNE	(		s1,
			s2
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)

EXPECT_THROW

#define EXPECT_THROW	(		statement,
			expected_exception
	)		GTEST_TEST_THROW_(statement, expected_exception, GTEST_NONFATAL_FAILURE_)

EXPECT_TRUE

#define EXPECT_TRUE

(

condition

)

Value:

GTEST_TEST_BOOLEAN_((condition), #condition, false, true, \
                      GTEST_NONFATAL_FAILURE_)

FAIL

#define FAIL

(

)

GTEST_FAIL()

GTEST_ASSERT_EQ

#define GTEST_ASSERT_EQ	(		val1,
			val2
	)

Value:

ASSERT_PRED_FORMAT2(::testing::internal:: \
                      EqHelper<GTEST_IS_NULL_LITERAL_(val1)>::Compare, \
                      val1, val2)

GTEST_ASSERT_GE

#define GTEST_ASSERT_GE	(		val1,
			val2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)

GTEST_ASSERT_GT

#define GTEST_ASSERT_GT	(		val1,
			val2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)

GTEST_ASSERT_LE

#define GTEST_ASSERT_LE	(		val1,
			val2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)

GTEST_ASSERT_LT

#define GTEST_ASSERT_LT	(		val1,
			val2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)

GTEST_ASSERT_NE

#define GTEST_ASSERT_NE	(		val1,
			val2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)

GTEST_FAIL

#define GTEST_FAIL

(

)

GTEST_FATAL_FAILURE_("Failed")

GTEST_IMPL_CMP_HELPER_

#define GTEST_IMPL_CMP_HELPER_	(		op_name,
			op
	)

Value:

template <typename T1, typename T2>\
AssertionResult CmpHelper##op_name(const char* expr1, const char* expr2, \
                                   const T1& val1, const T2& val2) {\
  if (val1 op val2) {\
    return AssertionSuccess();\
  } else {\
    return CmpHelperOpFailure(expr1, expr2, val1, val2, #op);\
  }\
}\
GTEST_API_ AssertionResult CmpHelper##op_name(\
    const char* expr1, const char* expr2, BiggestInt val1, BiggestInt val2)

GTEST_SUCCEED

#define GTEST_SUCCEED

(

)

GTEST_SUCCESS_("Succeeded")

GTEST_TEST

#define GTEST_TEST	(		test_case_name,
			test_name
	)

Value:

GTEST_TEST_(test_case_name, test_name, \
              ::testing::Test, ::testing::internal::GetTestTypeId())

SCOPED_TRACE

#define SCOPED_TRACE

(

message

)

Value:

::testing::internal::ScopedTrace GTEST_CONCAT_TOKEN_(gtest_trace_, __LINE__)(\
    __FILE__, __LINE__, ::testing::Message() << (message))

SUCCEED

#define SUCCEED

(

)

GTEST_SUCCEED()

TEST

#define TEST	(		test_case_name,
			test_name
	)		GTEST_TEST(test_case_name, test_name)

TEST_F

#define TEST_F	(		test_fixture,
			test_name
	)

Value:

GTEST_TEST_(test_fixture, test_name, test_fixture, \
              ::testing::internal::GetTypeId<test_fixture>())

Function Documentation

RUN_ALL_TESTS()

int RUN_ALL_TESTS ( )

inline