您可以监视桩函数执行以检查某些期望，例如对给定桩函数的调用数或桩函数调用的顺序。期望必须在测试用例中定义，并在测试用例执行完成后进行验证。如果未达到期望，则将生成一条适当的消息并将其输出到结果。在验证结果之后，在测试用例执行结束时将删除所有期望。

桩函数期望必须在对被测试函数的所有调用之前，以确保所有的桩函数调用都被计数。

您可以为使用以下配置之一启用的测试配置创建的子配置桩函数期望：

启用桩函数回调
启用桩函数 API(已弃用)

请查阅动态桩函数配置以获取更多信息。

下表描述了可用的期望类型：

期望	说明
`CPPTEST_EXPECT_NCALLS(<func-id>, <value>)`	期望调用 `<func-id>` 存根等于 `<value>`。
`CPPTEST_EXPECT_NCALLS_MORE_THAN(<func-id>, <value>)`	期望调用 `<func-id>` 存根的数量大于 `<value>`。
`CPPTEST_EXPECT_NCALLS_LESS_THAN(<func-id>, <value>)`	期望调用 `<func-id>` 存根的数量小于 `<value>`。
`CPPTEST_EXPECT_NCALLS_IN_RANGE(<func-id>,<min>,<max>)`	期望调用 `<func-id>` 存根的数量大于 `<min>` 但小于 `<max>`。
`CPPTEST_EXPECT_CALL_SEQUENCE()` `[Add<func-id>\|AddNTimes<func-id>]`	指定对存根的调用的预期序列

示例

以下示例提供了设置桩函数定义期望的典型方法。

桩函数调用期望的数量

为桩函数调用数量设置期望的 API 对于 C 和 C++ 是相同的。

定义对桩函数的确切调用数的期望：
在下面的示例中，预期 foo 存根被恰好调用 3 次。
CPPTEST_EXPECT_NCALLS("foo",3);
定义桩函数调用数量大于以下值的期望：
在下面的例子中，foo 存根被调用超过 3 次。
CPPTEST_EXPECT_NCALLS_MORE_THAN("foo",3);
定义桩函数调用数量小于以下值的期望：
在下面的示例中，预期 foo 存根被恰好调用 3 次。
CPPTEST_EXPECT_NCALLS_LESS_THAN("foo",3);
定义桩函数调用数量在范围内的期望：
在下面的示例中，预期 foo 存根被恰好调用 3 次。
CPPTEST_EXPECT_NCALLS_IN_RANGE("foo",3, 7);

桩函数调用期望值序列

定义桩函数调用序列的期望：

下面的示例设置了 foo -> goo -> foo (3times) -> goo 桩函数调用序列的期望值：

[C]   CPPTEST_EXPECT_CALL_SEQUENCE()->Add("foo")->Add(goo")->AddNTimes("foo", 3)->Add("goo");
[C++] CPPTEST_EXPECT_CALL_SEQUENCE().Add("foo").Add(goo").AddNTimes("foo", 3).Add("goo");

在以下情况下违背了本示例中所定义的期望

序列中指定的桩函数没有按照预测的顺序调用
在测试用例结束时，未调用预期序列中某些函数