Google Test 单元测试 语法教程 进阶篇（二）

我的网站是 https://ctestcode.cn   ，有许多非常好用的C语言开发工具。
大家可以关注我的公众号 ctestcode 交流更多的C 语言开发的经验。

Google Test 单元测试 语法教程 进阶篇（二）

在基础篇里，我们讲解了Google test 的基础 语法，基本已经够用，但在一些特殊的场景里，需要进阶的语法来描述单元测试的语句。让我们开始学习把。

语法  ASSERT_PRED1

使用场景: 自定义判断函数 对函数进行的值进行测试

在这个场景里，我们要测试add函数，但是判断条件比较复杂，所以用函数的形式写了一个判定条件 isGreaterThan10。

EXPECT_PRED2 的下标是2，代表自定义的判定函数有2个参数。当自定义函数有3个 参数时，则用ASSERT_PRED3,以此类推。

//  EXPECT_PRED2, 使用场景: 自定义判断函数 对函数进行的值进行测试

bool isGreaterThan10(short a ,short b)
{
    return add(a,b)>=10;
}
TEST(HelloGtest, case_EXPECT_PRED2_success)
{
    EXPECT_PRED2(isGreaterThan10,5,5);
}

ASSERT_PRED 自定义函数判定

使用返回值为布尔类型的函数进行判定

Fatal assertion	Nonfatal assertion	Verifies
ASSERT_PRED1(pred1, val1)	EXPECT_PRED1(pred1, val1)	pred1(val1) is true
ASSERT_PRED2(pred2, val1, val2)	EXPECT_PRED2(pred2, val1, val2)	pred2(val1, val2) is true
...	...	...

语法 AssertionResult

使用场景: 自定义判断函数,并输出额外信息

AssertionResult 作为返回值是 自定义函数的另外一种用法，当判定出错时，则可以通过AssertionFailure输出额外的信息。

// AssertionResult, 使用场景: 自定义判断函数,并输出额外信息

AssertionResult  isGreaterThan10_result(short a ,short b)
{
    if (add(a,b)>=10)
    {
        return AssertionSuccess() ;
    }
    return AssertionFailure() << "add " <<a<< '+'<<b<< "<10";
}
TEST(HelloGtest, case_AssertionResult)
{
    EXPECT_TRUE(isGreaterThan10_result(5,1));
}

AssertionResult 作为返回值，正确时，返回  AssertionSuccess();
错误时，返回AssertionFailure(); 同时通过重载符  <<输出错误信息

语法 EXPECT_PRED_FORMAT2

使用场景: 错误时，完全自定义错误消息

如果你已经厌倦gtest一层不变的输出，想加一些自定义的中文输出，就请用EXPECT_PRED_FORMAT2 来彻底改写gtest的输出风格吧

// EXPECT_PRED_FORMAT2, 使用场景: 错误时，完全自定义错误消息

AssertionResult  isGreaterThan10_format(const char* a_expr,const char* b_expr,int a ,int b) 
{
     if (add(a,b)>=10)
        return AssertionSuccess() ;
    return AssertionFailure() << "添加 " <<a_expr <<"("<<a<< ")+"<< b_expr<<"("<<b<< ")小于10";
}
TEST(HelloGtest, case_EXPECT_PRED_FORMAT2_fail)
{
    int a=5;
    int b=1;
    EXPECT_PRED_FORMAT2(isGreaterThan10_format,a,b);
}

EXPECT_PRED_FORMAT2 使用场景: 错误时，完全自定义错误消息

如果你对(ASSERT|EXPECT)_PRED*?and?(ASSERT|EXPECT)_(TRUE|FALSE) 输出格式不满意, 你可以自定义输出的消息格式

Fatal assertion	Nonfatal assertion	Verifies
ASSERT_PRED_FORMAT1(pred_format1, val1);	EXPECT_PRED_FORMAT1(pred_format1, val1);	pred_format1(val1)?is successful
ASSERT_PRED_FORMAT2(pred_format2, val1, val2);	EXPECT_PRED_FORMAT2(pred_format2, val1, val2);	pred_format2(val1, val2)?is successful
...	...	...

EXPECT_PRED_FORMAT2的语法格式

AssertionResult PredicateFormattern(const char* expr1,
                                    const char* expr2,
                                    const char* exprn,
                                    T1 val1,   
                                    T2 val2,
                                    Tn valn);

语法 ADD_FAILURE

使用场景: 显示地申明错误

本例中，对default情况，主动报错。

//显示得错误申明
void checkValue(int value)
{
    switch(value)
    {
        case 1: SUCCEED();break;
        case 0: SUCCEED();break;
        case -1:SUCCEED();break;
        default:ADD_FAILURE();
    }
}
TEST(HelloGtest, case_ADD_FAILURE)
{
   int value=compare(2,1);
   checkValue(value);
}

显示申明成功或失败，

SUCCEED();
FAIL();  
ADD_FAILURE();  
ADD_FAILURE_AT("file_path", line_number);

SUCCEED表示执行到当前位置时，状态是正确的。不会产生其他消息

FAIL() 会触发致命错误，整个case会终止,  ADD_FAILURE() and ADD_FAILURE_AT() 只是触发一般错误，case不会终止

注意: 你只能在返回值为void的函数里使用FAIL().

语法 EXPECT_DEATH

使用场景: 检验程序的退出码，退出信号，退出时打印的字符串

有人问，程序的异常退出码可以用gtest测试吗，回答当然是可以的。case_EXPECT_DEATH 里，GetNullPointer 获取空指针，程序异常退出前输出 Pointer XX is null，则可以被gtest框架捕捉到。并进行判定。

要注意的是 EXPECT_DEATH 第二个参数是一个 matcher,是可以对字符串进行正则表达式 匹配。

EXPECT_DEATH(statement, matcher);

TEST(DeathTest, case_EXPECT_DEATH)
{
   EXPECT_DEATH(
   {
        const char * p=GetNullPointer(2);
        fprintf(stderr,"Pointer %d is null",&p);
        fflush(stderr);
        if (p[0]=='T')
            printf("Should not enter here");
   },
   "\\d is null");
}

NormalExit 则是另外一个例子，当程序通过exit退出的错误码，也可以通过gtest 进行验证。

TEST(DeathTest, NormalExit) 
{
  EXPECT_EXIT( exit(456) ,ExitedWithCode(456), "");
}

Death Test终止测试详细内容

使用场景：检验程序的退出码，退出信号，退出时打印的字符串

终止测试的宏如下

Fatal assertion	Nonfatal assertion	Verifies
ASSERT_DEATH(statement, matcher);	EXPECT_DEATH(statement, matcher);	statement crashes with the given error
ASSERT_DEATH_IF_SUPPORTED(statement, matcher);	EXPECT_DEATH_IF_SUPPORTED(statement, matcher);	if death tests are supported, verifies that statement crashes with the given error; otherwise verifies nothing
ASSERT_DEBUG_DEATH(statement, matcher);	EXPECT_DEBUG_DEATH(statement, matcher);	statement crashes with the given error in debug mode. When not in debug (i.e. NDEBUG is defined), this just executes statement
ASSERT_EXIT(statement, predicate, matcher);	EXPECT_EXIT(statement, predicate, matcher);	statement exits with the given error, and its exit code matches predicate

 

设置期待程序退出时的exit code

ExitedWithCode(exit_code)

设置程序退出时收到的Signal (只支持在Linux上使用)

KilledBySignal(signal_number)  // Not available on Windows.

 

字符串检查支持正则表达式

Expression	Meaning
c	matches any literal character c
\\d	matches any decimal digit
\\D	matches any character that's not a decimal digit
\\f	matches \f
\\n	matches \n
\\r	matches \r
\\s	matches any ASCII whitespace, including \n
\\S	matches any character that's not a whitespace
\\t	matches \t
\\v	matches \v
\\w	matches any letter, _, or decimal digit
\\W	matches any character that \\w doesn't match
\\c	matches any literal character c, which must be a punctuation
.	matches any single character except \n
A?	matches 0 or 1 occurrences of A
A*	matches 0 or many occurrences of A
A+	matches 1 or many occurrences of A
^	matches the beginning of a string (not that of each line)
$	matches the end of a string (not that of each line)
xy	matches x followed by y

语法 SCOPED_TRACE

使用场景：判断失败时，显示帮助信息，包括文件和行号

本例中，如果case失败时，则在子函数SubFunction里，通过SCOPED_TRACE 输出额外信息，便于跟踪调试

void SubFunction()
{
    SCOPED_TRACE("TEST: SubFunction");
    ASSERT_TRUE(0);
}
TEST(HelloGtest, case_SCOPED_TRACE)
{
    int flag  = 0;
    int *p= UC::GetIntData(flag);
    SubFunction();
}

SCOPED_TRACE 可以添加到子函数中，用来补充错误时的信息

SCOPED_TRACE(message);

google test 进阶语法介绍完毕，内容有些复杂，不要紧，等需要使用的时候，大家可以可以过来再温习一下，作为单元测试 手册先收藏吧。