软件工程课程设计采用的VSS注释

/*******************************************************************
*
*文 件 名： $Workfile: 语音传输重构.cpp $
*
*程 序 员： $Author: Globe $
*
*描 述：
*
*最后修改时间：$Modtime: 05-03-23 7:54p $
*
*修 订 次 数： $Revision: 0 $
*
*修 订 记 录： $History: 语音传输重构.cpp $
*
*******************************************************************/

文件开头的注释模板（建议用SourceSafe自动生成里面的大部分信息，具体见目录：李欲版本控制软件(看里面的readme)）

/*******************************************************************

*

*文 件 名：

*

*程 序 员：

*

*描 述：

*

*最后修改时间：

*

*修 订 次 数：

*

*修 订 记 录：

*

*******************************************************************/

变量命名规范-----采用匈牙利命名法：

匈牙利命名法通过在变量名前面加上相应的小写字母的符号标识作为前缀，标识出变量的作用域，类型等。这些符号可以多个同时使用，顺序是先m_（成员变量），再指针，再简单数据类型，其他。例如：m_lpszStr, 表示指向一个以0字符结尾的字符串的长指针成员变量。
匈牙利命名法关键是：标识符的名字以一个或者多个小写字母开头作为前缀；前缀之后的是首字母大写的一个单词或多个单词组合，该单词要指明变量的用途。

强烈建议大家都采用前两个表作为我们的编码规范，方便大家看代码和帮忙找错误。其它就结合大家的习惯了，但需要在变量名中体现比变量类型和变量意义。

一般前缀命名规范

前缀	类型	实例
C	类或结构	CDocument，CPrintInfo
m_	成员变量	m_pDoc，m_nCustomers
g_	全局变量(尽量不要用)	g_nMsg, g_bFlag

变量命名规范

前缀	类型	描述	实例
ch	char	8位字符	chGrade
sz	char *	字符指针，即字符串	szName
b	BOOL	布尔值	bEnable
n	int	整型（其大小依赖于操作系统）	nLength
n	UINT	无符号值（其大小依赖于操作系统）	nHeight
w	WORD	16位无符号值	wPos
l	LONG	32位有符号整型	lOffset
dw	DWORD	32位无符号整型	dwRange
p	*	指针	pDoc
ch	TCHAR	如果_UNICODE定义，则为16位字符	chName
lp	FAR*	远指针	lpszName
lpsz	LPSTR	32位字符串指针	lpszName
lpsz	LPCSTR	32位常量字符串指针	lpszName
lpsz	LPCTSTR	如果_UNICODE定义，则为32位常量字符串指针	lpszName
h	handle	Windows对象句柄	hWnd
lpfn	callback	指向CALLBACK函数的远指针	LpfnName
str	CString	MFC中常用的字符串类型	strName

MFC、句柄、控件及结构的命名规范

Windows类型	样本变量	MFC类	样本变量
HWND	hWnd；	CWnd*	pWnd；
HDLG	hDlg；	CDialog*	pDlg；
HDC	hDC；	CDC*	pDC；
HGDIOBJ	hGdiObj；	CGdiObject*	pGdiObj；
HPEN	hPen；	CPen*	pPen；
HBRUSH	hBrush；	CBrush*	pBrush；
HFONT	hFont；	CFont*	pFont；
HBITMAP	hBitmap；	CBitmap*	pBitmap；
HPALETTE	hPaltte；	CPalette*	pPalette；
HRGN	hRgn；	CRgn*	pRgn；
HMENU	hMenu；	CMenu*	pMenu；
HWND	hCtl；	CState*	pState；
HWND	hCtl；	CButton*	pButton；
HWND	hCtl；	CEdit*	pEdit；
HWND	hCtl；	CListBox*	pListBox；
HWND	hCtl；	CComboBox*	pComboBox；
©著作权归作者所有：来自51CTO博客作者globe的原创作品，如需转载，请注明出处，否则将追究法律责任 职场 休闲 编程人生 0 分享 微博 QQ 微信 收藏 上一篇：cppunit 在vc6.0下的... 下一篇：走了，离开机房 globe 20篇文章，9W+人气，0粉丝 Ctrl+Enter 发布 发布 取消 1条评论 按时间倒序 按时间正序 推荐专栏更多 带你玩转高可用 前百度高级工程师的架构高可用实战 共15章 | 曹林华 ￥51.00 495人订阅 订   阅 微服务技术架构和大数据治理实战 大数据时代的微服务之路 共18章 | 纯洁微笑 ￥51.00 688人订阅 订   阅 猜你喜欢 我的友情链接 CET6纪念碑 我们不得不面对的中年职场危机 Java线程：线程的调度-休眠 用光影魔术手制作一寸照片（8张一寸） 职场终极密籍--记我的职业生涯 我的IT职场生涯: 毕业4年，月薪过万 Linux关闭休眠和屏保模式 年薪从0到10万-我的IT职场经验总结 Windows7删除休眠文件hiberfil.sys节省大量C盘空间 致IT同仁 — IT人士常犯的17个职场错误 “跳槽加薪”现象，无奈的职场规则 Ansible开发环境搭建 让用户帮你做测试（A/B测试） 案例：隐秘而低调的内存泄露（OOM） 使用Jmeter测试java请求 jmeter学习指南之生成html性能结果报告（篇幅较长谨慎阅读） Jmeter + Grafana搭建实时监控可视化 jmeter学习指南之快速玩转16个逻辑控制器 jmeter学习指南之关联 扫一扫,领取大礼包 0 1 分享 globe