函数相关
1、参数的书写要完整
参数的书写要完整,不要贪图省事只写参数的类型而省略参数名字。如果函数没有参数,则用void填充。例如:
voidSetValue(intwidth,intheight); // 良好的风格
voidSetValue(int,int); // 不良的风格
floatGetValue(void); // 良好的风格
floatGetValue(); // 不良的风格
2、参数命名要恰当,顺序要合理
例如编写字符串拷贝函数StringCopy,它有两个参数。如果把参数名字起为str1和str2,例如:
void StringCopy(char*str1,char*str2);
那么我们很难搞清楚究竟是把str1拷贝到str2中,还是刚好倒过来。
可以把参数名字起得更有意义,如叫strSource
和strDestination
。这样从名字上就可以看出应该把strSource拷贝到strDestination。
还有一个问题,这两个参数那一个该在前那一个该在后?参数的顺序要遵循程序员的习惯。一般地,应将目的参数放在前面,源参数放在后面:
void StringCopy(char*strDestination,char*strSource);
3、参数是指针
如果参数是指针,且仅作输入用,则应在类型前加const,以防止该指针在函数体内被意外修改。
例如:
void StringCopy(char*strDestination,constchar*strSource);
4、不要省略返回值的类型
C语言中,凡不加类型说明的函数,一律自动按整型处理。这样做不会有什么好处,却容易被误解为void类型。
5、函数名字与返回值类型在语义上不可冲突
违反这条规则的典型代表是C标准库函数getchar
。例如:
charc;
c=getchar();
if(c==EOF)
…
按照getchar名字的意思,将变量c声明为char类型是很自然的事情。但不幸的是getchar的确不是char类型,而是int类型,其原型如下:
int getchar(void);
由于c是char类型,取值范围是[-128,127],如果宏EOF的值在char的取值范围之外,那么if语句将总是失败,这种“危险”人们一般哪里料得到!导致本例错误的责任并不在用户,是函数getchar
误导了使用者。
6、不要将正常值和错误标志混在一起返回
正常值用输出参数获得,而错误标志用return语句返回。
回顾上例,C标准库函数的设计者为什么要将getchar声明为令人迷糊的int类型呢?
在正常情况下,getchar的确返回单个字符。但如果getchar碰到文件结束标志或发生读错误,它必须返回一个标志EOF。为了区别于正常的字符,只好将EOF定义为负数(通常为负1)。因此函数getchar就成了int类型。
我们在实际工作中,经常会碰到上述令人为难的问题。为了避免出现误解,我们应该将正常值和错误标志分开。即:正常值用输出参数获得,而错误标志用return语句返回。
函数getchar
可以改写成BOOL GetChar(char*c);
。
7、附加返回值,增强函数的灵活性
有时候函数原本不需要返回值,但为了增加灵活性如支持链式表达,可以附加返回值。例如字符串拷贝函数strcpy
的原型:
char *strcpy(char *strDest,const char *strSrc);
strcpy函数将strSrc拷贝至输出参数strDest中,同时函数的返回值又是strDest。这样做并非多此一举,可以获得如下灵活性:
char str[20];
int length=strlen(strcpy(str,“HelloWorld”));
以上就是本次的分享,欢迎转发!