gtest assertion

1 Introduction

  gtest, the assert macro can be understood as divided into two categories, one is ASSERT series, one is EXPECT series.
ASSERT_ * series of assertions, when the checkpoint failed to exit the current function (note: not exit the current case)
EXPECT_ * series of assertions, when the checkpoint fails, continue down the implementation. Outputs expected and actual values in the result, can be exported in an XML file

2, custom information output

  Automatic output of error messages are not satisfied, you can also customize some of the information output by the << operator. Without the use of << operator to customize the output, the current view in the cycle than the expected value cycle, such as:
  EXPECT_EQ (X [I], Y [I]);
Actual:. 4
the Expected: X [I]
Which is: 3

<< operator using custom outputs such as:
EXPECT_EQ (X [I], Y [I]) << "Vectors X and Y Differ AT index" << I;
result: Actual:. 4
the Expected: X [I]
IS Which:. 3
Vectors X and Y index Differ AT 2

3, Boolean

  ASSERT_TRUE (condition); EXPECT_TRUE (condition ); the condition is true
  ASSERT_FALSE (condition); EXPECT_FALSE (condition ); the condition is false

4, numerical data checking

  ASSERT_EQ(expected, actual); EXPECT_EQ(expected, actual); 判断==
  ASSERT_NE(val1, val2); EXPECT_NE(val1, val2); 判断 !=
  ASSERT_LT(val1, val2); EXPECT_LT(val1, val2); 判断 <
  ASSERT_LE(val1, val2); EXPECT_LE(val1, val2); 判断 <=
  ASSERT_GT(val1, val2); EXPECT_GT(val1, val2); 判断 >
  ASSERT_GE(val1, val2); EXPECT_GE(val1, val2); 判断 >=

5, the string is checked

  ASSERT_STREQ (expected_str, actual_str); EXPECT_STREQ (expected_str, actual_str); the contents of the same string
  ASSERT_STRNE (str1, str2); EXPECT_STRNE (str1, str2); different content strings
  ASSERT_STRCASEEQ (expected_str, actual_str); EXPECT_STRCASEEQ (expected_str, actual_str ); the contents of the same string, ignoring case
  ASSERT_STRCASENE (str1, str2); EXPECT_STRCASENE (str1, str2); different contents of the string, ignoring case

  * STREQ * and * STRNE * Supports char * and wchar_t * type, * STRCASEEQ * and * STRCASENE * but only receives char * .

6, the display returns success or failure

  Direct return success: SUCCEED ();
  returns failure:
    FAIL (); // do not execute down the case
    ADD_FAILURE (); // continue down

7, abnormal inspection

  ASSERT_THROW (statement, exception_type); EXPECT_THROW (statement, exception_type); statement given type of exception initiator

  ASSERT_ANY_THROW (statement); EXPECT_ANY_THROW (statement ); statements raise any type of exception
  ASSERT_NO_THROW (statement); EXPECT_NO_THROW (statement ); statement does not throw any exception

8, Predicate Assertions assert predicate

  When using EXPECT_TRUE or ASSERT_TRUE, sometimes you want to be able to output more detailed information, such as when checking the return value of TRUE or FALSE a function, what hope can output parameter is passed, in order to better track after the failure.

  ASSERT_PRED1 (pred1, val1); EXPECT_PRED1 (pred1, val1); pred1 (val1) returns true
  ASSERT_PRED2 (pred2, val1, val2) ; EXPECT_PRED2 (pred2, val1, val2); pred2 (val1, val2) returns true
  .... .. ...


8.1 自定义的输出格式

  ASSERT_PRED_FORMAT1(pred_format1, val1);` EXPECT_PRED_FORMAT1(pred_format1, val1); pred_format1(val1) 成功
  ASSERT_PRED_FORMAT2(pred_format2, val1, val2); EXPECT_PRED_FORMAT2(pred_format2, val1, val2); pred_format2(val1, val2) 成功

8.2 用法

  testing::Message msg;
  msg << m_expr << " 和 " << n_expr << " 的最大公约数应该是:" << Foo(m, n) << " 而不是:" << k_expr;
3)返回 testing::AssertionFailure(msg);
  EXPECT_PRED_FORMAT3(AssertFoo, 3, 6, 2);

testing::AssertionResult AssertFoo(const char* m_expr, const char* n_expr, const char* k_expr, int m, int n, int k) {
if (Foo(m, n) == k)
return testing::AssertionSuccess();
testing::Message msg;
msg << m_expr << " 和 " << n_expr << " 的最大公约数应该是:" << Foo(m, n) << " 而不是:" << k_expr;
return testing::AssertionFailure(msg);

TEST(AssertFooTest, HandleFail)
EXPECT_PRED_FORMAT3(AssertFoo, 3, 6, 2);


  ASSERT_FLOAT_EQ(expected, actual); EXPECT_FLOAT_EQ(expected, actual); 两个浮点值几乎相等
  ASSERT_DOUBLE_EQ(expected, actual); EXPECT_DOUBLE_EQ(expected, actual); 两个双精度值几乎相等

  ASSERT_NEAR(val1, val2, abs_error); EXPECT_NEAR(val1, val2, abs_error); val1和val2之间的差异不超过给定的绝对误差

  EXPECT_PRED_FORMAT2(testing::FloatLE, val1, val2);
  EXPECT_PRED_FORMAT2(testing::DoubleLE, val1, val2);

10、Windows HRESULT断言



template <typename T> class FooType {
void Bar() { testing::StaticAssertTypeEq<int, T>(); }

TEST(TypeAssertionTest, Demo)
FooType<bool> fooType;

Guess you like