- 1、本文档共41页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
3. 代码注释 最新.课件 * 恰到好处的注释 1. 对重要变量说明其作用; 2. 对每一段函数代码加注释说明功能; 3. 对重要的语句加注释说明其功能; 4. 对重要的函数调用的参数加实际参数说明; 5. 在自己认为必要的地方加上注释 6. 可以采用/* */和//进行注释 最新.课件 * 4. 基本编辑规范要求 正确使用:缩进,空格,空行 最新.课件 * 缩进 根据语句间的层次关系采用缩进格式书写程序,每进一层,往后缩进一层 函数内的变量声明与执行语句要缩进一层 缩进长函数调用语句 pMsg = ComReadMsgFromQueue( aServer, NULL, ComWait_c, lTimeOut ); 一个缩进层次为四个英文字符宽度 一般用Tab键进行缩进,定义Tab为四个英文字符宽度 许多开发工具编辑器如VC一般会自动帮你缩进 最新.课件 * 要加空格的场合 1. 在逗号后面和语句中间的分号后面加空格,如: int i, j, k; for (i = 0; i n; i++) Result = func(a, b, c); 2. 在二目运算符的两边各留一个空格,如 a b a = b i = 0 3. 关键字两侧,如if () …, 不要写成if() … 4. 类型与指针说明符之间一定要加空格: char *szName; 最新.课件 * 不要加空格的场合 1. 在结构成员引用符号.和-左右两加不加空格:pStud-szName, Student.nID 2. 不要在行尾加多余的空格或Tab 3. 函数名与左括号之间不要加空格: func(…) 4. 指针说明符号*与变量名间不要加空格: int *pInt; 不要写成: int * pInt; 5. 复合运算符中间不能加空格,否则会产生语法错误,如: a + = b a = b 都是错误的 最新.课件 * 空行与换行 1. 函数的变量说明与执行语句之间加上空行; 2. 每个函数内的主要功能块之间加空行表示区隔; 3. 一行语句不要写的太长,将长语句分成多行写; 4. 不要在一行中写多条语句. 最新.课件 * 例子 int main() { int i, j, nSum = 0; //变量说明 for (i = 0; i 10; i++) //执行代码 { for (j = 0; j 10; j++) { nSum += i; } } } 注意空格 空行 注意各层缩进 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 最新.课件 * 编码规范 最新.课件 * 第一部分 前言 Preface 最新.课件 * 为什么要这么做? 书写良好的代码更容易阅读 容易阅读的代码才容易被理解 容易被理解的代码才健康 编程风格体现了程序员对语言的理解水平 求职:好的编程风格给别人良好的第一印象,是获得高薪的第一步 最新.课件 * 1. 编写目的 通过编程规范的学习和强制执行,使同学们从一开始就接触基本的软件开发思想,了解基本的软件工程规范,养成良好的编程习惯;为后续课程的实践环节和日后实际工作打下良好的基础;也便于教师批改与回复电子作业。 执行良好的编码规范可以使编写出来的程序易于阅读、理解和管理。 最新.课件 * 2. 编码规范的定义 编码(coding):是指用适当的代码编写工具编写C语言程序的源代码 编码规范: 相关英文说法:coding standard, coding convention, coding criterion 是指被普通采用的、或由某个企业或机构规定的,用计算机语言编写程序的过程中需要遵守的一套规则或约定的集合 编码规范并不是语言的语法规则 最新.课件 * 3. 编码规范的应用 在软件业高速发展、团队开发成为基本开发模式的今天,几乎每个软件企业或软件开发团队都会制定各种各样的规范,应用于软件开发过程的各个环节中,编码规范是最基础规范之一。 不同的公司,对同一种开发语言,一般都采用类似的规范,也就是说编码规范具有一些通用性的标准 最新.课件 * 4. 编码规范的学习和执行 要求学习和掌握规范标准 要求在本课程的作业过程中执行这些规范,上交的电子作业必须符合这些规范要求 要求在后续相关课程中执行此规范中的基本部分,并根据后续课程内容要求执行相应的扩展规范 最新.课件 * 第二部分 C语言编码规范 Coding standards 最新.课件 * 1. 文件级模块说明规范 File m
您可能关注的文档
- 资料CRRT治疗中的液体管理.ppt
- 全面CRRT中的抗凝治疗.ppt
- CRRT中药物调整(已看,很好)经典.ppt
- 演示课件CRRT中液体与抗凝管理.ppt
- CSP封装技术(方案).ppt
- 汇总CTIEC压力管道设计.ppt
- CT基本操作技术(部位齐全)回顾.ppt
- CUPT乒乓球实验报告复习.ppt
- 论述d3d创建几何体.ppt
- 报告DAN是主要的遗传物质.ppt
- 农民专业合作社管理规定流程.docx
- 南京航空航天大学本科毕业设计(论文)任务书【模板】.docx
- 排序的实验报告范文.docx
- 南开18春学期(1709、1803)《计算机应用基础》在线作业100分答案2.docx
- 南开大学22春“计算机科学与技术”《大学计算机基础》作业考核题库高频考点版(参考答案)试题号5.docx
- 派出所调解申请书(实用19篇).docx
- 南开大学22春“计算机科学与技术”《大学计算机基础》期末考试高频考点版(带答案)试卷号1.docx
- 女人要好好爱自己的句子-女人要善待自己的句子.docx
- 农村村民入党申请书.docx
- 南开19春(1709、1803、1809、1903)学期《市场营销》在线作业满分答案1.docx
文档评论(0)