+ -
当前位置:首页 → 问答吧 → 求C语言SDK编程方式下的如何给函数取名字

求C语言SDK编程方式下的如何给函数取名字

时间:2011-12-25

来源:互联网

小弟正在学习C语言,用SDK的方法编写一点小软件,但是用C语言的方法,要写很多的函数,
要取一堆的函数名称 ,还有另外一堆的标识符的名字,代码越写越多,名字越来越乱。
找一个函数都要辗转反侧好几次,感觉好抑郁啊。

希望有高人可以指下一下迷津,再下不胜感激。

看看我现在写的名字。
C/C++ code

// 此代码模块中包含的函数的前向声明:
 
BOOL WinOnInitInstance(HINSTANCE, int);
void WinOnExitInstance(HINSTANCE, int);
 
LRESULT CALLBACK    WinProc(HWND, UINT, WPARAM, LPARAM);
INT_PTR CALLBACK    About(HWND, UINT, WPARAM, LPARAM);


//窗口消息函数声明
void WinOnClose(HWND hwnd);
void WinOnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify);
void WinOnDestroy(HWND hwnd);
BOOL WinOnInitDialog(HWND hwnd, HWND hwndFocus, LPARAM lParam); 
void WinOnPaint(HWND hwnd); 
void WinOnSize(HWND hwnd, UINT state, int cx, int cy);
BOOL WinOnNotify(HWND hwnd, int idFrom,LPNMHDR pNmhdr) ;

//功能函数声明
//////////////////////////////////////////////////////////////////////////
void WinDoInitForm(HWND hwnd);
void WinDoInitWork(HWND hwnd);
void winDoSetMenu(HWND hwnd);

//业务函数
//////////////////////////////////////////////////////////////////////////
BOOL winDoConnectDB(HWND hwnd);



希望有热心人,能提供一点如下建议:

一、不同模块的函数取名 规则
二、不同模块的标识识的取名规则 

谢谢啦。

作者: asmfox   发布时间: 2011-12-25

古语说,“名不正同言不顺”,名字--标识符的命名很重要。
函数的名字的一般命名要求(规则)是:
1.动词或词组表示函数的功能、行为--尽可能准确--在线词典很必要--用英语不要用汉语拼音
2.名字的长度取词于函数的使用频度和跨度--频繁调用的函数名字简单些,跨度(声明和定义及调用的代码距离)大的名字完整些
3.为了阅读顺畅、尽可能不使用缩写--仅仅为了少打几个字符而阅读时猜测函数设计者的意图很累
4.功能相近、相异的要基于相同词根
5.函数名的动词与参数的名词结合就给了函数的基本意图
6.。。。。
几本书,建议看看:
代码大全
编程匠艺
代码整洁之道
高质量C、C++程序设计(?--林锐的)
一些公司的编程规范--我以为有些走火入魔--要求的太细、太表面化了

作者: cao_julians   发布时间: 2011-12-25