- 1、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。。
- 2、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
1.程序约定1.1排版规则1)程序应采用缩进风格编写,每层缩进以4个.doc
1. 程序约定
1.1 排版规则
程序应采用缩进风格编写,每层缩进以4个空格为单位对齐(不允许使用TAB字符代替),类定义、方法都应顶格书写;
花括号必须单独一行并且对齐,左花括号上一行代码的缩进相同,下一行代码则缩进一层。
一个变量定义占一行,一个语句占一行;
对独立的程序块之间、变量说明之后必须加空行;
对于较长的语句(80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读;绝对不允许一行代码超出120个字符。
不同类型的操作符连接除了加减乘除运算符,不管是否影响运算秩序,必须使用括号表示运算秩序以方便阅读,做到不知道运算符优先级的人阅读代码也不会有二义性。
循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分;
在对结构体成员赋值,一组变量赋值等情况,等号对齐;
运算符的前后必须至少一个空格。
若函数或过程中的参数较长,则要进行适当的划分。
形参的排序风格:
最常使用的参数放在第一位;
输入参数列表应放在输出参数列表的左边;
将通用的参数放在特殊的参数的左边
代码中的数值常量必须使用类型修饰符。相等不等及大小判断时,常量必须放在运算符的左边。
switch-cast语句必须有default,除非case语句将switch的对象的类型的取值范围内的的所有数值都罗列了。如果有case语句不需要break,也必须将break语句写上然后注释,并特别说明break语句不需要。
1.2 命名约定
1.2.1 应用程序的命名
“公司缩写”+模块名称+[版本]
1.2.2 子模块的命名
每个子模块的名字应该由描述模块功能的1-3个单词组成。每个单词的首字母应大写。在这些单词中可以使用一些公认的、具有特殊含义的或者经过特别说明的缩写。
1.2.3 变量的命名
变量的命名的基本原则是使得变量的含义能够从名字中直接理解。可以用多个英文单词拼写而成,每个英文单词的首字母要大写,其中英文单词有缩写的可用缩写;变量的前缀表示该变量的类型;对于作用域跨越10行以上的变量名称不能少于4个字符,除循环变量、累加变量外不得使用i、j、k等名称的变量???循环变量尽量使用能表示循环意义的单词。变量分为全局变量和局部变量,全局变量必须加前缀“g_”。
变量类型前缀说明变量类型前缀说明intn整形值BYTEby8位无符号整形值longl长整形值COLORREFcr32位的颜色值unsigned intui无符号整形值DWORDdw32位无符号整形值unsigned longul无符号长整形值LONGln32位整形值charc字符LPARAMlparam32位值,作为参数给窗口过程或回调函数char *p字符数组LPCSTR lpcsz32位指针,常量字符串char *sz以\0结尾的字符串LPSTRlpsz32位指针,字符串Floatf单精度浮点值LPCTSTRlpcsz32位指针,常量字符串,Unicode和DBCSDoubled双精度浮点值LPTSTRlpsz32位指针,字符串,Unicode和DBCSBoolb布尔型LPVOIDp32位指针,没有指定指针类型LRESULTlr32位的返回值UINTu无符号整形值WNDPROCpwnd32位窗口过程指针WORDw16位无符号整形值POSITIONposMFC集合类中,显示元素在集合中的位置WPARAMwparam32位值,作为参数给窗口过程或回调函数LPCRECTpc32位指针,指向常量RECT结构指针p一般指针类变量通用前缀列因office系统自动拼写检查可能有大写字母,本文作者的本意是它们都是小写字母。
另外,要注意的是:全局变量在程序中不要定义太多,能用局部变量的就用局部变量。如果要使用相关的变量,建议采用类的方式或者结构的方式存放,以减少具体变量的个数。如果在编码时需要增加文档规定外的全局变量,需要通知项目组其他人员讨论通过,并且在在文档追加对该全局变量的说明,追加者,使用范围及约束条件。
1.2.4 常量的命名
常量所有的字母均为大写。并且单词之间使用下划线”_”隔开。
1.2.5 函数/过程的命名
函数/过程名称应该尽量使用能够表达函数功能的英文名称,函数名称中应该禁止使用如同function1,function2等含义不清的名称。单词间应该使用大小写分隔。全局函数以“g”前缀开始。
1.2.6 接口命名
接口名称要以大写字母开头。如果接口包含多个单词,每个单词的首字母大写,其他字母小写,如果,这些单
您可能关注的文档
最近下载
- TB-T 2491-1994 扣件组装疲劳试验方法.pdf VIP
- 短节段融合内固定治疗成人退变性脊柱侧凸并发症-中国骨与关节杂志.pdf VIP
- 2025年银行纪检笔试题目及答案.doc VIP
- 《企业经营决策讲义》课件.ppt VIP
- 中小学生牛奶配送项目 投标方案.docx
- 2024年贵州省黔东南苗族侗族自治州凯里市鸭塘镇招聘社区工作者真题及参考答案详解.docx VIP
- 样板工程验收记录.docx
- YY_T 0466.1-2023 医疗器械 用于制造商提供信息的符号 第1部分通用要求.pdf
- 七年级数学新课标下的单元教学设计实践研究.docx VIP
- 燃气发生器结构和系统详解.ppt VIP
文档评论(0)