📄 rcunit__proc_8c.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: src/rcunit_proc.c文件参考</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><div class="nav"><a class="el" href="dir_000002.html">src</a></div><h1>rcunit_proc.c文件参考</h1><hr><a name="_details"></a><h2>详细描述</h2>定义注册、执行和清理测试用例以及测试集的函数。 <p>虽然这里所有的函数都可以被外部调用到，但是请不要直接使用这些函数，而使用各种没有以下划线开头的宏。 <p>在文件<a class="el" href="rcunit__proc_8c-source.html">rcunit_proc.c</a>中定义。<p><code>#include <stdio.h></code><br><code>#include <string.h></code><br><code>#include <malloc.h></code><br><code>#include <stdlib.h></code><br><code>#include <stdarg.h></code><br><code>#include "<a class="el" href="rcunit_8h-source.html">../include/rcunit/rcunit.h</a>"</code><br><code>#include "<a class="el" href="rcunit__mem_8h-source.html">../include/rcunit/rcunit_mem.h</a>"</code><br><p><a href="rcunit__proc_8c-source.html">浏览该文件的源代码。</a><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">void </td><td class="memItemRight" valign="bottom"><a class="el" href="rcunit__proc_8c.html#a1">_CUnit_RunAllTest</a> ()</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">执行所有的测试用例。. <a href="#a1"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="rcunit__proc_8c.html#a2">_CUnit_AddTestSuite</a> (<a class="el" href="struct____tagCUnitTestSuite.html">__CUNIT_TEST_SUITE_S</a> *pSuite)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">注册测试集（Test Suite）。 <a href="#a2"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="rcunit__proc_8c.html#a3">_CUnit_FreeTestSuiteList</a> ()</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">释放测试用例集（Test Suite）链表。. <a href="#a3"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="rcunit__proc_8c.html#a4">_CUnit_AddTestCase</a> (<a class="el" href="struct____tagCUnitTestSuite.html">__CUNIT_TEST_SUITE_S</a> *pHead, __CUNIT_TEST_CASE_FUNC_TYPE funcCase, const char *szName)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">增加测试用例。. <a href="#a4"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="rcunit__proc_8c.html#a5">_CUnit_FreeTestCaseList</a> (<a class="el" href="struct____tagCUnitTestSuite.html">__CUNIT_TEST_SUITE_S</a> *pHead)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">释放测试用例链表。. <a href="#a5"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a6" doxytag="rcunit_proc.c::_CUnit_Dummy_Event_Handler"></a>void </td><td class="memItemRight" valign="bottom"><a class="el" href="rcunit__proc_8c.html#a6">_CUnit_Dummy_Event_Handler</a> ()</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">空函数，什么都不做，用做默认的setUp和tearDown函数。 <br></td></tr></table><hr><h2>函数文档</h2><a class="anchor" name="a4" doxytag="rcunit_proc.c::_CUnit_AddTestCase"></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">int _CUnit_AddTestCase </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="struct____tagCUnitTestSuite.html">__CUNIT_TEST_SUITE_S</a> * </td> <td class="mdname" nowrap> <em>pHead</em>, </td> </tr> <tr> <td class="md" nowrap align="right"></td> <td class="md"></td> <td class="md" nowrap>__CUNIT_TEST_CASE_FUNC_TYPE </td> <td class="mdname" nowrap> <em>funcCase</em>, </td> </tr> <tr> <td class="md" nowrap align="right"></td> <td class="md"></td> <td class="md" nowrap>const char * </td> <td class="mdname" nowrap> <em>szName</em></td> </tr> <tr> <td class="md"></td> <td class="md">) </td> <td class="md" colspan="2"></td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>增加测试用例。. <p>该函数将测试用例注册到待指定的测试集（Test Suite）中去。 <dl compact><dt><b>注解:</b></dt><dd>请不要直接使用这个函数，而使用 <a class="el" href="group__rcunit__write__test__suite.html#ga3">CUNIT_TEST() </a> 来注册测试用例。 </dd></dl><p>在文件<a class="el" href="rcunit__proc_8c-source.html">rcunit_proc.c</a>第<a class="el" href="rcunit__proc_8c-source.html#l00181">181</a>行定义。<p>参考 <a class="el" href="rcunit__mem_8h-source.html#l00015">_CUNIT_MALLOC</a>、<a class="el" href="rcunit__def_8h-source.html#l00014">CUNIT_RET_FAILED</a>、<a class="el" href="rcunit__def_8h-source.html#l00013">CUNIT_RET_OK</a>、<a class="el" href="rcunit__case_8h-source.html#l00023">__tagCUnitTestCaseListNode::func</a>、<a class="el" href="rcunit__suite_8h-source.html#l00027">__tagCUnitTestSuite::head</a>、<a class="el" href="rcunit__case_8h-source.html#l00024">__tagCUnitTestCaseListNode::name</a>、<a class="el" href="rcunit__case_8h-source.html#l00022">__tagCUnitTestCaseListNode::next</a>及<a class="el" href="rcunit__suite_8h-source.html#l00028">__tagCUnitTestSuite::tail</a>. </td> </tr></table><a class="anchor" name="a2" doxytag="rcunit_proc.c::_CUnit_AddTestSuite"></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">int _CUnit_AddTestSuite </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="struct____tagCUnitTestSuite.html">__CUNIT_TEST_SUITE_S</a> * </td> <td class="mdname1" valign="top" nowrap> <em>pSuite</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>注册测试集（Test Suite）。 <p>该函数将测试集注册到待执行的测试集列表中去。 <dl compact><dt><b>注解:</b></dt><dd>请不要直接使用这个函数，而使用 <a class="el" href="group__rcunit__registing__test__suite.html#ga0">CUNIT_ADD_TEST_SUITE() </a> 来注册测试集。 </dd></dl><p>在文件<a class="el" href="rcunit__proc_8c-source.html">rcunit_proc.c</a>第<a class="el" href="rcunit__proc_8c-source.html#l00137">137</a>行定义。<p>参考 <a class="el" href="rcunit__mem_8h-source.html#l00015">_CUNIT_MALLOC</a>、<a class="el" href="rcunit__def_8h-source.html#l00014">CUNIT_RET_FAILED</a>、<a class="el" href="rcunit__def_8h-source.html#l00013">CUNIT_RET_OK</a>、<a class="el" href="rcunit__suite_8h-source.html#l00043">__tagCUnitTestSuiteListNode::isFailed</a>、<a class="el" href="rcunit__suite_8h-source.html#l00041">__tagCUnitTestSuiteListNode::next</a>及<a class="el" href="rcunit__suite_8h-source.html#l00042">__tagCUnitTestSuiteListNode::suite</a>. </td> </tr></table><a class="anchor" name="a5" doxytag="rcunit_proc.c::_CUnit_FreeTestCaseList"></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">void _CUnit_FreeTestCaseList </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="struct____tagCUnitTestSuite.html">__CUNIT_TEST_SUITE_S</a> * </td> <td class="mdname1" valign="top" nowrap> <em>pHead</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>释放测试用例链表。. <p>释放指定测试集（Test Suite）中所有注册的测试用例。 <p>在文件<a class="el" href="rcunit__proc_8c-source.html">rcunit_proc.c</a>第<a class="el" href="rcunit__proc_8c-source.html#l00215">215</a>行定义。<p>参考 <a class="el" href="rcunit__mem_8h-source.html#l00019">_CUNIT_FREE</a>、<a class="el" href="rcunit__suite_8h-source.html#l00027">__tagCUnitTestSuite::head</a>、<a class="el" href="rcunit__case_8h-source.html#l00022">__tagCUnitTestCaseListNode::next</a>及<a class="el" href="rcunit__suite_8h-source.html#l00028">__tagCUnitTestSuite::tail</a>.<p>参考自 <a class="el" href="rcunit__proc_8c-source.html#l00159">_CUnit_FreeTestSuiteList()</a>. </td> </tr></table><a class="anchor" name="a3" doxytag="rcunit_proc.c::_CUnit_FreeTestSuiteList"></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">void _CUnit_FreeTestSuiteList </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>释放测试用例集（Test Suite）链表。. <p>释放所有已注册的测试集以及其中的测试用例。 <p>在文件<a class="el" href="rcunit__proc_8c-source.html">rcunit_proc.c</a>第<a class="el" href="rcunit__proc_8c-source.html#l00159">159</a>行定义。<p>参考 <a class="el" href="rcunit__mem_8h-source.html#l00019">_CUNIT_FREE</a>、<a class="el" href="rcunit__proc_8c-source.html#l00215">_CUnit_FreeTestCaseList()</a>、<a class="el" href="rcunit__suite_8h-source.html#l00041">__tagCUnitTestSuiteListNode::next</a>及<a class="el" href="rcunit__suite_8h-source.html#l00042">__tagCUnitTestSuiteListNode::suite</a>.<p>参考自 <a class="el" href="rcunit__proc_8c-source.html#l00028">_CUnit_RunAllTest()</a>. </td> </tr></table><a class="anchor" name="a1" doxytag="rcunit_proc.c::_CUnit_RunAllTest"></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">void _CUnit_RunAllTest </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr></table><table cellspacing="5" cellpadding="0" border="0"> <tr> <td> </td> <td><p>执行所有的测试用例。. <p>该函数将遍历所有的测试集（Test Suite）和套件里面的测试用例（Test Case），并逐一执行、收集产生的错误信息， 最后统一输出到命令行。 <dl compact><dt><b>注解:</b></dt><dd>请不要直接使用这个函数，而使用 <a class="el" href="group__rcunit__running__test__case.html#ga0">CUNIT_RUN_TEST() </a> 来执行所有的测试用例。 </dd></dl><p>在文件<a class="el" href="rcunit__proc_8c-source.html">rcunit_proc.c</a>第<a class="el" href="rcunit__proc_8c-source.html#l00028">28</a>行定义。<p>参考 <a class="el" href="rcunit__mem_8h-source.html#l00019">_CUNIT_FREE</a>、<a class="el" href="rcunit__proc_8c-source.html#l00159">_CUnit_FreeTestSuiteList()</a>、<a class="el" href="rcunit__asserter_8c-source.html#l00057">_CUnit_GetBlockedCaseCount()</a>、<a class="el" href="rcunit__asserter_8c-source.html#l00069">_CUnit_GetErrorMsg()</a>、<a class="el" href="rcunit__mem_8h-source.html#l00015">_CUNIT_MALLOC</a>、<a class="el" href="rcunit__asserter_8c-source.html#l00063">_CUnit_ResetBlockedCaseCount()</a>、<a class="el" href="rcunit__def_8h-source.html#l00014">CUNIT_RET_FAILED</a>、<a class="el" href="rcunit__suite_8h-source.html#l00027">__tagCUnitTestSuite::head</a>、<a class="el" href="rcunit__suite_8h-source.html#l00043">__tagCUnitTestSuiteListNode::isFailed</a>、<a class="el" href="rcunit__case_8h-source.html#l00035">__tagCUnitTestCaseFailedMsg::msg</a>、<a class="el" href="rcunit__suite_8h-source.html#l00041">__tagCUnitTestSuiteListNode::next</a>、<a class="el" href="rcunit__case_8h-source.html#l00034">__tagCUnitTestCaseFailedMsg::next</a>、<a class="el" href="rcunit__suite_8h-source.html#l00029">__tagCUnitTestSuite::setUp</a>、<a class="el" href="rcunit__suite_8h-source.html#l00042">__tagCUnitTestSuiteListNode::suite</a>及<a class="el" href="rcunit__suite_8h-source.html#l00030">__tagCUnitTestSuite::tearDown</a>. </td> </tr></table><hr/><table width="100%"> <tr> <td align="right" valign="center"> 如果对 RCUnit 有任何的疑问或建议，请联系realdodo (<a href="mailto:realdodo@163.com">realdodo@163.com</a>)。 </td> </tr></table></body> </html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -