C语言函数设计的一般原则和技巧
C语言函数设计的一般原则和技巧
C语言的设计目标是提供一种能以简易的方式编译、处理低级存储器、产生少量的机器码以及不需要任何运行环境支持便能运行的编程语言。那么C语言函数设计的一般原则和技巧都是怎样的呢?以下仅供参考!
C语言函数设计的一般原则和技巧 篇1
具体如下:
1、原则上尽量少使用全局变量,因为全局变量的生命周期太长,容易出错,也会长时间占用空间.各个源文件负责本身文件的全局变量,同时提供一对对外函数,方便其它函数使用该函数来访问变量。
比如:niSet_ValueName(…);niGet_ValueName(…);不要直接读写全局变量,尤其是在多线程编程时,必须使用这种方式,并且对读写操作加锁。
2、参数命名要恰当,顺序要合理。
例如编写字符串拷贝函数str_copy,它有两个参数。如果把参数名字起为str1 和str2,例如
void str_copy (char *str1, char *str2);
那么我们很难搞清楚究竟是把str1 拷贝到str2 中,还是刚好倒过来。
可以把参数名字起得更有意义,如叫strSource 和strDestination。这样从名字上就可以看出应该把strSource 拷贝到strDestination。
还有一个问题,这两个参数那一个该在前那一个该在后?参数的顺序要遵循程序员的习惯。一般地,应将目的参数放在前面,源参数放在后面。如果将函数声明为:
void str_copy (char *strSource, char *strDestination);
别人在使用时可能会不假思索地写成如下形式:
char str[20];
str_copy (str, “Hello World”); 参数顺序颠倒
3、如果参数是指针,且仅作输入参数用,则应在类型前加const,以防止该指针在函数体内被意外修改。例如:
void str_copy (char *strDestination,const char *strSource);
4、不要省略返回值的类型,如果函数没有返回值,那么应声明为void 类型。
如果没有返回值,编译器则默认为函数的返回值是int类型的.。
5、在函数体的“入口处”,对参数的有效性进行检查。尤其是指针参数,尽量使用assert宏做入口校验,而不使用if语句校验。(关于此问题讨论,详见指针与数组那章。)
6、return 语句不可返回指向“栈内存”的“指针”,因为该内存在函数体结束时被自动销毁。例如:
char * Func(void)
{
char str[30];
return str;
}
str 属于局部变量,位于栈内存中,在Func 结束的时候被释放,所以返回str 将导致错误。
7、函数的功能要单一,不要设计多用途的函数。微软的Win32 API就是违反本规则的典型,其函数往往因为参数不一样而功能不一,导致很多初学者迷惑。
8、函数体的规模要小,尽量控制在80 行代码之内。
9、相同的输入应当产生相同的输出。尽量避免函数带有“记忆”功能。
带有“记忆”功能的函数,其行为可能是不可预测的,因为它的行为可能取决于某种“记忆状态“。这样的函数既不易理解又不利于测试和维护。在C 语言中,函数的static局部变量是函数的“记忆”存储器。建议尽量少用static 局部变量,除非必需。
10、避免函数有太多的参数,参数个数尽量控制在4个或4个以内。如果参数太多,在使用时容易将参数类型或顺序搞错。微软的Win32 API就是违反本规则的典型,其函数的参数往往七八个甚至十余个。比如一个CreateWindow函数的参数就达11个之多。输出函数printf使用方法
11、尽量不要使用类型和数目不确定的参数。
C 标准库函数printf 是采用不确定参数的典型代表,其原型为:
int printf(const chat *format[, argument]…);
这种风格的函数在编译时丧失了严格的类型安全检查。
12、有时候函数不需要返回值,但为了增加灵活性如支持链式表达,可以附加返回值。例如字符串拷贝函数strcpy 的原型:
char *strcpy(char *strDest,const char *strSrc);
strcpy 函数将strSrc 拷贝至输出参数strDest 中,同时函数的返回值又是strDest。这样做并非多此一举,可以获得如下灵活性:
char str[20];
int length = strlen(strcpy(str, “Hello World”) );
13、不仅要检查输入参数的有效性,还要检查通过其它途径进入函数体内的变量的有效性,例如全局变量、文件句柄等。
14、函数名与返回值类型在语义上不可冲突。
违反这条规则的典型代表就是C语言标准库函数getchar。几乎没有一部名著没有提到getchar函数,因为它实在太经典,太容易让人犯错误了。所以,每一个有经验的作者都会拿这个例子来警示他的读者,我这里也是如此
C语言函数设计的一般原则和技巧 篇2
函数设计原则
1、函数从意义上是一个独立的功能模块
2、函数名要在一定程度上反映函数的功能
3、函数参数名要能够体现参数的意义
4、尽量避免在函数中使用全局变量
void sc(char *s1, char *s2);
void str_copy(char *str_dest, char *str_src);
1、当函数参数不应该在函数体内部被修改时,应该加上const声明
2、如果参数是指针,且仅作输入参数,则应加上const声明
void str_copy(char *str_dest, const char *str_src);
函数的返回类型
1、不能省略返回值得类型
a、如果函数没有返回值,那么就应该声明为void 类型,(应为在C语言中默认的返回类型为int)
2、对参数进行有效性检查
a、对于指针参数的检查尤为重要
3、不要返回指向“栈内存”的指针
a、栈内存在函数体结束时被自动释放
函数的规模
1、函数体的规模要小,尽量控制在80行代码以内;
2、相同的输入对应相同输出,避免函数带有“记忆”的功能;
3、避免函数有过多的参数,参数个数尽量控制在4个以内。
【C语言函数设计的一般原则和技巧】