【文件属性】：
文件名称：函数设计-用elk打造安全数据分析平台
文件大小：2.15MB
文件格式：PDF
更新时间：2021-06-10 16:17:55
51单片机
5.5 函数设计
函数是C程序的基本功能单元，其重要性不言而喻。函数设计的细微缺点很容易导致该
函数被错用，所以光使函数的功能正确是不够的。本节重点论述函数的接口设计和内部实现
的一些规则。
函数接口的两个要素是参数和返回值。C语言中，函数的参数和返回值的传递方式有两
种：值传递（pass by value）和指针传递（pass by pointer）。
5.5.1 参数的规则
【规则5-5-1-1】参数的书写要完整，不要贪图省事只写参数的类型而省略参数名字。如果函
数没有参数，则用void 填充。例如：
void SetValue(int width, int height); // 良好的风格
void SetValue(int, int); // 不良的风格
float GetValue(void); // 良好的风格
float GetValue(); // 不良的风格
【规则5-5-1-2】参数命名要恰当，顺序要合理。
例如编写字符串拷贝函数StringCopy，它有两个参数。如果把参数名字起为str1和str2，
例如
void StringCopy(char *str1, char *str2);
那么我们很难搞清楚究竟是把str1拷贝到str2中，还是刚好倒过来。可以把参数名字起
得更有意义，如叫strSource 和strDestination。这样从名字上就可以看出应该把strSource
拷贝到strDestination。
还有一个问题，这两个参数那一个该在前那一个该在后？参数的顺序要遵循程序员的习
惯。一般地，应将目的参数放在前面，源参数放在后面。
如果将函数声明为：
void StringCopy(char *strSource, char *strDestination);
别人在使用时可能会不假思索地写成如下形式：
char str[20];
StringCopy(str, “Hello World”); // 参数顺序颠倒
【规则5-5-1-3】如果参数是指针，且仅作输入用，则应在类型前加const，以防止该指针在
函数体内被意外修改。例如：
void StringCopy(char *strDestination, const char *strSource);
〖建议5-5-1-1〗避免函数有太多的参数，参数个数尽量控制在5个以内。如果参数太多，在
使用时容易将参数类型或顺序搞错。
5.5.2 返回值的规则
【规则5-5-2-1】不要省略返回值的类型。如果函数没有返回值，那么应声明为void类型。
【规则5-5-2-2】函数名字与返回值类型在语义上不可冲突。
违反这条规则的典型代表是C标准库函数getchar。例如：
中国科学技术大学业余无线电协会 77