📄 group__rcunit__making__assertion.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"><title>RCUnit: 使用断言</title><link href="doxygen.css" rel="stylesheet" type="text/css"></head><body><!-- 制作者 Doxygen 1.4.2 --><div class="qindex"><a class="qindex" href="index.html">首页</a> | <a class="qindex" href="modules.html">模块</a> | <a class="qindex" href="annotated.html">数据结构</a> | <a class="qindex" href="dirs.html">目录</a> | <a class="qindex" href="files.html">文件列表</a> | <a class="qindex" href="functions.html">数据字段</a> | <a class="qindex" href="globals.html">全局定义</a> | <a class="qindex" href="pages.html">相关页面</a></div><h1>使用断言</h1><p><table border="0" cellpadding="0" cellspacing="0"><tr><td></td></tr><tr><td colspan="2"><br><h2>宏定义</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rcunit__making__assertion.html#ga0">CUNIT_ASSERT_EQUAL</a>(x, y) _CUNIT_ASSERT_EQUAL_INTERNAL(x, y, __FILE__, __LINE__)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">断言传入的整数必须相等的宏 <a href="#ga0"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rcunit__making__assertion.html#ga1">CUNIT_ASSERT_DOUBLES_EQUAL</a>(x, y, delta) _CUNIT_ASSERT_DOUBLES_EQUAL_INTERNAL(x, y, delta, __FILE__, __LINE__)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">断言传入的浮点数必须相等的宏 <a href="#ga1"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rcunit__making__assertion.html#ga2">CUNIT_ASSERT_STRINGS_EQUAL</a>(x, y) _CUNIT_ASSERT_STRINGS_EQUAL_INTERNAL(x, y, __FILE__, __LINE__)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">断言传入的浮点数必须相等的宏 <a href="#ga2"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rcunit__making__assertion.html#ga3">CUNIT_ASSERT</a>(x) _CUNIT_ASSERT_INTERNAL(x, #x, __FILE__, __LINE__)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">断言传入值必须为真的宏 <a href="#ga3"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rcunit__making__assertion.html#ga4">CUNIT_ASSERT_TRUE</a>(x) CUNIT_ASSERT(x)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">断言传入值必须为真的宏 <a href="#ga4"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rcunit__making__assertion.html#ga5">CUNIT_ASSERT_FALSE</a>(x) CUNIT_ASSERT(!(x))</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">断言传入值必须为假的宏 <a href="#ga5"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__rcunit__making__assertion.html#ga6">CUNIT_ASSERT_FAIL</a>(msg) _CUNIT_ASSERT_FAIL_INTERNAL(msg, __FILE__, __LINE__)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">引发断言并输出用户自定义的信息. <a href="#ga6"></a><br></td></tr></table><hr><h2>宏定义文档</h2><a class="anchor" name="ga3" doxytag="rcunit_assert.h::CUNIT_ASSERT"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define CUNIT_ASSERT </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">x </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> _CUNIT_ASSERT_INTERNAL(x, #x, __FILE__, __LINE__)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>断言传入值必须为真的宏 <p><dl compact><dt><b>参数:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>x</em> </td><td>期望的比较结果，应该为真，否则会引发断言</td></tr> </table></dl><dl compact><dt><b>使用方法:</b></dt><dd><div class="fragment"><pre class="fragment"> <span class="keywordtype">void</span> TestSomething() { <span class="keywordtype">int</span> nRet = DoSomething(); <span class="comment">// the return value of DoSomething() should be 2</span> <a class="code" href="group__rcunit__making__assertion.html#ga3">CUNIT_ASSERT</a>(2 == nRet); <span class="comment">// this assert will ensure the value of nRet</span> }</pre></div> </dd></dl><p>在文件<a class="el" href="rcunit__assert_8h-source.html">rcunit_assert.h</a>第<a class="el" href="rcunit__assert_8h-source.html#l00087">87</a>行定义。 </td> </tr></table><a class="anchor" name="ga1" doxytag="rcunit_assert.h::CUNIT_ASSERT_DOUBLES_EQUAL"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define CUNIT_ASSERT_DOUBLES_EQUAL </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">x, <tr> <td class="md" nowrap align="right"></td> <td class="md"></td> <td class="md" nowrap>y, <tr> <td class="md" nowrap align="right"></td> <td class="md"></td> <td class="md" nowrap>delta </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> _CUNIT_ASSERT_DOUBLES_EQUAL_INTERNAL(x, y, delta, __FILE__, __LINE__)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>断言传入的浮点数必须相等的宏 <p><dl compact><dt><b>参数:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>x</em> </td><td>是期望的值，一般把常量放在这里 </td></tr> <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>y</em> </td><td>是实际的值，一般把动态获得的值放在这里 </td></tr> <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>delta</em> </td><td>是要求的精度</td></tr> </table></dl><dl compact><dt><b>使用方法:</b></dt><dd><div class="fragment"><pre class="fragment"> <span class="keywordtype">void</span> TestSomething() { <span class="keywordtype">int</span> nRet = DoSomething(); <span class="comment">// the return value of DoSomething() should be 2.5</span> <a class="code" href="group__rcunit__making__assertion.html#ga1">CUNIT_ASSERT_DOUBLES_EQUAL</a>(2.5, nRet, 1e-5); <span class="comment">// this assert will ensure the value of nRet</span> }</pre></div> </dd></dl><p>在文件<a class="el" href="rcunit__assert_8h-source.html">rcunit_assert.h</a>第<a class="el" href="rcunit__assert_8h-source.html#l00055">55</a>行定义。 </td> </tr></table><a class="anchor" name="ga0" doxytag="rcunit_assert.h::CUNIT_ASSERT_EQUAL"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define CUNIT_ASSERT_EQUAL </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">x, <tr> <td class="md" nowrap align="right"></td> <td class="md"></td> <td class="md" nowrap>y </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> _CUNIT_ASSERT_EQUAL_INTERNAL(x, y, __FILE__, __LINE__)</td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>断言传入的整数必须相等的宏 <p><dl compact><dt><b>参数:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>x</em> </td><td>是期望的值，一般把常量放在这里 </td></tr> <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>y</em> </td><td>是实际的值，一般把动态获得的值放在这里</td></tr> </table></dl><dl compact><dt><b>使用方法:</b></dt><dd><div class="fragment"><pre class="fragment"> <span class="keywordtype">void</span> TestSomething() { <span class="keywordtype">int</span> nRet = DoSomething(); <span class="comment">// the return value of DoSomething() should be 2</span> <a class="code" href="group__rcunit__making__assertion.html#ga0">CUNIT_ASSERT_EQUAL</a>(2, nRet); <span class="comment">// this assert will ensure the value of nRet</span> }</pre></div> </dd></dl><p>在文件<a class="el" href="rcunit__assert_8h-source.html">rcunit_assert.h</a>第<a class="el" href="rcunit__assert_8h-source.html#l00038">38</a>行定义。 </td> </tr></table><a class="anchor" name="ga6" doxytag="rcunit_assert.h::CUNIT_ASSERT_FAIL"></a><p><table class="mdTable" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top">#define CUNIT_ASSERT_FAIL </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">msg </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> _CUNIT_ASSERT_FAIL_INTERNAL(msg, __FILE__, __LINE__)</td>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -