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:

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

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::FormatForComparison< ToPrint, OtherOperand >
class	testing::internal::FormatForComparison< ToPrint[N], OtherOperand >
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_FORMAT_C_STRING_AS_POINTER_(CharType)
#define	GTEST_IMPL_FORMAT_C_STRING_AS_STRING_(CharType, OtherStringType)
#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(expected, actual)
#define	EXPECT_NE(expected, actual)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, expected, actual)
#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(expected, actual)
#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(expected, actual)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, expected, actual)
#define	EXPECT_STRNE(s1, s2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)
#define	EXPECT_STRCASEEQ(expected, actual)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, expected, actual)
#define	EXPECT_STRCASENE(s1, s2)   EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)
#define	ASSERT_STREQ(expected, actual)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, expected, actual)
#define	ASSERT_STRNE(s1, s2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)
#define	ASSERT_STRCASEEQ(expected, actual)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, expected, actual)
#define	ASSERT_STRCASENE(s1, s2)   ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)
#define	EXPECT_FLOAT_EQ(expected, actual)
#define	EXPECT_DOUBLE_EQ(expected, actual)
#define	ASSERT_FLOAT_EQ(expected, actual)
#define	ASSERT_DOUBLE_EQ(expected, actual)
#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)
	testing::internal::GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_ (char)
	testing::internal::GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_ (wchar_t)
	testing::internal::GTEST_IMPL_FORMAT_C_STRING_AS_STRING_ (char,::std::string)
template<typename T1 , typename T2 >
std::string	testing::internal::FormatForComparisonFailureMessage (const T1 &value, const T2 &)
template<typename T1 , typename T2 >
AssertionResult	testing::internal::CmpHelperEQ (const char *expected_expression, const char *actual_expression, const T1 &expected, const T2 &actual)
GTEST_API_ AssertionResult	testing::internal::CmpHelperEQ (const char *expected_expression, const char *actual_expression, BiggestInt expected, BiggestInt actual)
	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 *expected_expression, const char *actual_expression, const char *expected, const char *actual)
GTEST_API_ AssertionResult	testing::internal::CmpHelperSTRCASEEQ (const char *expected_expression, const char *actual_expression, const char *expected, const char *actual)
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 *expected_expression, const char *actual_expression, const wchar_t *expected, const wchar_t *actual)
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 *expected_expression, const char *actual_expression, RawType expected, RawType actual)
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

#define ADD_FAILURE

(

)

GTEST_NONFATAL_FAILURE_("Failed")

Referenced by testing::ValidateTestPropertyName().

#define ADD_FAILURE_AT	(		file,
			line
	)

Value:

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

#define ASSERT_ANY_THROW

(

statement

)

GTEST_TEST_ANY_THROW_(statement, GTEST_FATAL_FAILURE_)

#define ASSERT_DOUBLE_EQ	(		expected,
			actual
	)

Value:

ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \
                      expected, actual)

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

#define ASSERT_FALSE

(

condition

)

Value:

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

#define ASSERT_FLOAT_EQ	(		expected,
			actual
	)

Value:

ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \
                      expected, actual)

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

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

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

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

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

#define ASSERT_NEAR	(		val1,
			val2,
			abs_error
	)

Value:

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

#define ASSERT_NO_FATAL_FAILURE

(

statement

)

GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_FATAL_FAILURE_)

#define ASSERT_NO_THROW

(

statement

)

GTEST_TEST_NO_THROW_(statement, GTEST_FATAL_FAILURE_)

#define ASSERT_STRCASEEQ	(		expected,
			actual
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, expected, actual)

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

#define ASSERT_STREQ	(		expected,
			actual
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, expected, actual)

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

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

#define ASSERT_TRUE

(

condition

)

Value:

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

#define EXPECT_ANY_THROW

(

statement

)

GTEST_TEST_ANY_THROW_(statement, GTEST_NONFATAL_FAILURE_)

#define EXPECT_DOUBLE_EQ	(		expected,
			actual
	)

Value:

EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \
                      expected, actual)

#define EXPECT_EQ	(		expected,
			actual
	)

Value:

EXPECT_PRED_FORMAT2(::testing::internal:: \
                      EqHelper<GTEST_IS_NULL_LITERAL_(expected)>::Compare, \
                      expected, actual)

#define EXPECT_FALSE

(

condition

)

Value:

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

#define EXPECT_FLOAT_EQ	(		expected,
			actual
	)

Value:

EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \
                      expected, actual)

#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 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_NE	(		expected,
			actual
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, expected, actual)

#define EXPECT_NEAR	(		val1,
			val2,
			abs_error
	)

Value:

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

#define EXPECT_NO_FATAL_FAILURE

(

statement

)

GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_NONFATAL_FAILURE_)

#define EXPECT_NO_THROW

(

statement

)

GTEST_TEST_NO_THROW_(statement, GTEST_NONFATAL_FAILURE_)

#define EXPECT_STRCASEEQ	(		expected,
			actual
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, expected, actual)

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

#define EXPECT_STREQ	(		expected,
			actual
	)		EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, expected, actual)

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

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

#define EXPECT_TRUE

(

condition

)

Value:

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

#define FAIL

(

)

GTEST_FAIL()

#define GTEST_ASSERT_EQ	(		expected,
			actual
	)

Value:

ASSERT_PRED_FORMAT2(::testing::internal:: \
                      EqHelper<GTEST_IS_NULL_LITERAL_(expected)>::Compare, \
                      expected, actual)

#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 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_NE	(		val1,
			val2
	)		ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)

#define GTEST_FAIL

(

)

GTEST_FATAL_FAILURE_("Failed")

#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 AssertionFailure() \
        << "Expected: (" << expr1 << ") " #op " (" << expr2\
        << "), actual: " << FormatForComparisonFailureMessage(val1, val2)\
        << " vs " << FormatForComparisonFailureMessage(val2, val1);\
  }\
}\
GTEST_API_ AssertionResult CmpHelper##op_name(\
    const char* expr1, const char* expr2, BiggestInt val1, BiggestInt val2)

#define GTEST_IMPL_FORMAT_C_STRING_AS_POINTER_

(

CharType

)

Value:

template <typename OtherOperand>                                      \
  class FormatForComparison<CharType*, OtherOperand> {                  \
   public:                                                              \
    static ::std::string Format(CharType* value) {                      \
      return ::testing::PrintToString(static_cast<const void*>(value)); \
    }                                                                   \
  }

#define GTEST_IMPL_FORMAT_C_STRING_AS_STRING_	(		CharType,
			OtherStringType
	)

Value:

template <>                                                           \
  class FormatForComparison<CharType*, OtherStringType> {               \
   public:                                                              \
    static ::std::string Format(CharType* value) {                      \
      return ::testing::PrintToString(value);                           \
    }                                                                   \
  }

#define GTEST_SUCCEED

(

)

GTEST_SUCCESS_("Succeeded")

#define GTEST_TEST	(		test_case_name,
			test_name
	)

Value:

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

#define SCOPED_TRACE

(

message

)

Value:

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

#define SUCCEED

(

)

GTEST_SUCCEED()

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

#define TEST_F	(		test_fixture,
			test_name
	)

Value:

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

Function Documentation

int RUN_ALL_TESTS ( )

inline

Referenced by main().