# dev函数说明文档 ## 一、工程说明 - 本工程的配置类型是一个exe可执行文件,工程内存在四个函数接口,分别为加、减、乘、除。加法函数接口是调用add静态库实现;减法函数接口是采用在工程中配置加载sub动态库的方式实现;乘法接口以运行时加载动态库mul的方式实现;除法接口调用本身函数的方式实现。 ## 二、工程文件 1. 除法函数 - 头文件 dev.h ,放的是dev的声明 ```C #pragma once #include #include /* **函数名: dev **参数:int ,int **返回值:int **函数功能:传入两个int类型的参数,对其进行除法运算并返回两数之商。 */ int dev(int x, int y); ``` - 源文件 dev.cpp ,放的是dev函数的定义 ```C #include "dev.h" int dev(int x, int y) { if (y == 0) { printf("除数不能为0!\n"); return 0; } else { printf("%d / %d = %d\n", x, y, x / y); return x / y; } } ``` 2. 加、减、乘、接口 - 头文件 Oper_api.h ,放的是add_api,sub_api,mul_api接口声明 ```C #pragma once #include"sub.h" #include #include #pragma comment(lib,"./B.lib") typedef int(WINAPI* MulFunc)(int x, int y); /* **函数名: add_api **参数:int ,int **返回值:long long **函数功能:传入两个int类型的参数,调用静态库add函数的方式实现。 */ long long add_api(int x, int y); /* **函数名: sub_api **参数:int ,int **返回值:int **函数功能:传入两个int类型的参数,调用动态库sub函数的方式实现。 */ int sub_api(int x, int y); /* **函数名: mul_api **参数:int ,int **返回值:long long **函数功能:传入两个int类型的参数,运行时加载动态库mul,实现乘法运算。 */ void mul_api(int x, int y); ``` - 源文件 Oper_api.cpp ,放的是add_api,sub_api,mul_api接口定义 ```C #pragma once #include "Opera_api.h" #include"add.h" //函数接口add_api的实现 long long add_api(int x, int y) { long long res = add(x, y); printf("%d + %d = %lld\n", x, y, res); return res; } //函数接口sub_api的实现 int sub_api(int x, int y) { printf("%d - %d = %d\n", x, y, x - y); return x - y; } //函数接口mul_api的实现 long long mul_api(int x, int y) { HMODULE hdll = LoadLibrary("../../C/Debug/C.dll"); if (hdll != NULL) { MulFunc MUL1 = (MulFunc)GetProcAddress(hdll, (char*)(1)); if (MUL1 != NULL) { printf("%d * %d = %lld\n", x, y, MUL1(x, y)); return MUL1(x, y); } FreeLibrary(hdll); } } ``` 3. 调用函数 main.c ,对接口进行调用 ```C #include "Opera_api.h" #include "dev.h" int main() { int a = 2147483647, b = 2; add_api(a, b);//调用 加法接口add_api sub_api(a, b);//调用 减法接口sub_api mul_api(a, b); //调用 乘法接口mul_api dev(a, b);//调用 除法接口dev_api return 0; } ``` 4. 运行结果如下: ![](./pic/main.jpg) ## 三、单元测试 - 手动创建ini文件并添加测试样例,之后在单元测试的源文件里对ini文件进行读取解析 ,完成以后获取单元测试的结果,保证代码覆盖率在80%以上。其中对ini文件的读取另封装了函数,见下面的源码。 1. ini文件内容 exl.ini ``` [TestMethod1] #测试样例1 na=10 #函数第一个入数 nb=2 #函数第二个入参 nExpect=5 #两个入参相除的正确结果 [TestMethod2] na=12 nb=3 nExpect=4 [TestMethod3] na=90 nb=3 nExpect=30 ``` 2. 读取ini文件的函数 int CalcCount(int n, char(*str)[10]) ```C /* **函数功能:获取一个ini文件里有多少个节,并通过二维指针数组将节名带出来。 * 函数名:CalcCount() * 入参:int n --------节的个数 * char (*str)[10] --------二维数组指针,10是节名的长度,可以根据需求修改 *返回值:int --------返回节的个数 */ int CalcCount(int n, char(*str)[10]) int CalcCount(int n, char(*str)[10]) { TCHAR chSectionNames[2048] = { 0 };//定义一个数组,保存读取节的名字 char* pSectionName; //保存找到的某个节名字符串的首地址 int i = 0; //i指向数组chSectionNames的某个位置,从0开始,顺序后移 int j = 0; //j用来保存下一个节名字符串的首地址相对于当前i的位置偏移量 int k = 0; //临时变量,用于给str数组赋值 int m = 0; //临时变量,用于给str数组赋值 int count = 0; //统计节的个数 GetPrivateProfileSectionNames(chSectionNames, 2048, "..//ex1.ini");//获取文件中的节名,每个节名以"\0"分割,保存在chSectionNames中 //要加头文件 for (i = 0; i < 2048; i++, j++)//对chSectionName中保存的内容进行拆分 { if (chSectionNames[0] == '\0')//如果第一个字符就是0,则说明ini中一个节也没有, { break; } if (chSectionNames[i] == '\0') { count++; pSectionName = &chSectionNames[i - j]; //找到一个0,则说明从这个字符往前,减掉j个偏移量, //就是一个节名的首地址 j = -1; //找到一个节名后,j的值要还原,以统计下一个节名地址的偏移量 //赋成-1是因为节名字符串的最后一个字符0是终止符,不能作为节名 for (m = 0; m <= strlen(pSectionName); m++)//把找到的节名保存到str中 { str[k][m] = *(pSectionName + m); } k++;//变量自加,用来保存下一个节名 //在获取节名的时候可以获取该节中键的值,前提是我们知道该节中有哪些键。 if (chSectionNames[i + 1] == 0) { break; //当两个相邻的字符都是0时,则所有的节名都已找到,循环终止 } } } return count;//返回节名的个数 } ``` 3. 单元测试源码 UNITest1.cpp ```C #include "pch.h" #include "CppUnitTest.h" #include #include #include"../FourOperator/dev.h" #define FilePath "../ex1.ini" using namespace Microsoft::VisualStudio::CppUnitTestFramework; namespace UnitTest1 { TEST_CLASS(UnitTest1) { public: int j = 0;//循环变量,用来访问ini文件中的 节 char str[50][10] = { 0 };//存放ini文件里 节的名字 int count = CalcCount(50, str);//保存ini文件里 节的个数 TEST_METHOD(TestMethode1) { int nReal;//保存运算结果 CString na, nb, nExpect; //保存测试样例中的键值 for (j = 0; j < count; j++)//遍历读取测试样例 { GetPrivateProfileString(str[j], "na", " ", na.GetBuffer(20), 20, FilePath);//读取第一个参数,保存在na里 GetPrivateProfileString(str[j], "nb", " ", nb.GetBuffer(20), 20, FilePath);//读取第二个参数,保存在nb里 GetPrivateProfileString(str[j], "nExpect", " ", nExpect.GetBuffer(20), 20, FilePath);//读取正确的值,保存在nExpect里 nReal = dev(_ttoi(na), _ttoi(nb)); //_ttoi是CString转为整型,把运算结果给nReal Assert::AreEqual(nReal, _ttoi(nExpect));//对比运算结果和正确结果 } } }; } ```