- 1、本文档共12页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
- 5、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
- 6、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们。
- 7、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 8、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
查看更多
良好编程习惯
良好的编程习惯
良好的习惯对于人的成长是非常重要的,良好的编程习惯对于我们编程能力的提高也是非常重要的。我们编程时要有良好的风格,源代码的逻辑简明清晰,易读易懂是好程序的重要标准。
其实编程的过程中最容易忽略的还是程序的“风格”。这些东东有时让人挺烦的,刚刚放射出光茫的思想似乎被约束住了,本来是灵感发现,还要在后面罗索上半天。
程序需要风格吗?让我们的程序写得更加平易近人,更加生动对我们的编程是大有益处的。对我们的程序学习也能起到事半功倍的作用。编程过程中遵守的不成文的标准,对于我们和他人的交流和自己的再学习都是有益无害的。毕竟有时我们写的程序不是只给自己看的,也不是一时兴起,不管以后。 好的编码可使源代码的可读性强且意义清楚,与其他语言约定相一致,并且尽可能直观。我们自己一眼能看出个大概,在别人眼中也不至于成为千古奇书。下面以VB为例,对程序风格做一下全面的概述,希望对您的编程水平的提高有所帮助。
一、程序内部文档应具备的规则
1、标识符应含有含义鲜明的文字。
含义鲜明的文字,能正确地提示程序对象所代表的实体。这对于帮助阅读者理解程序是非常重要的。如果用缩写的形式,那么缩写规则应该一致,并且应该给每个名字加注解。在VB中,主要有如下的约定:
(一)对象命名约定
应该使用一致的前缀来命名对象,使人们容易识别对象的类型。例如我们常用控件CommandButton(命令按钮)可用cmd做为其前缀。Form以frm,Image以 img ,Label以 lbl,List Box 以lst,PictureBox以 pic,Timer以 tmr,等等,在我们编程的过程中,我们看到下面的名称cmdExit我们就知道这一定是一个命令按钮了。如果是第三方提供的控件,我们的说明最好要清晰地标出制造商的名称,以区别于我们的常用控件。
(二)常量和变量命名约定
除了控件以外,常量和变量也是我们编程过程中经常遇到的,我们和他们打交道也是通过名字。
(1)给变量加范围前缀
变量按其作用范围可分做三类,过程级,模块级和全局,所以我们在编程的过程中应将三者加以区别。我们在使用变量时,为了更好地体现代码重用和可维护原则,其定义范围应尽量缩小,这样将使我们的应用程序更加容易理解和易于控制。在VB应用程序中,只有当没有其他方便途径在窗体间共享数据时才使用全局变量。当使用全局变量时,在一个单一模块中声明它们,并按功能分组,给模块取一个有意义的名字。较好的编码习惯是尽可能地定模块化的代码。除了全局变量,过程和函数应该仅对传递给它们的的对象操作。在过程中使用的全局变量应该在过程起始处的声明部分标识出来。变量的作用范围前缀如下:全局 g(global) ,模块级 m(model),本地过程不需要使用。例如:gintFlag,表示全局整型变量,mstrPassword,可表示模块级字符型变量。
(2)声明所有变量原则。声明所有变量将会节省编程时间,键入错误将大大减少,我们可在程序开始写上如下语句:
Option Explicit
该语句要求在程序中声明所有变量。
(3)变量数据类型声明。可通过下面的前缀来做为变量的数据类标志。
Boolean bln
Byte byt
Double dbl
Integer int
String str
(4)常量。常量的命名,可遵循与变量命名大体相同的原则。
(5)对变量和过程名作出描述。变量或过程名的主体应该使用大小写混合的形式,并且应该足够长以描述它的作用。而且,函数名应以一个动词开头。如JudgeDialog。
2、适当的注解
注解是程序员和程序读者通信的重要手段,正确的注解非常有助于对程序的理解。VB中代码注解约定如下:所有的过程和函数都应该以描述这段过程的功能的一段简明的注释开始,说明该程序是干什么的,至于是如何做的,也就是编程的细节,最好不要包括。因为可能日后我们要修改程序,这样做会带来不必要的注释维护工作,如果不修改,将提供误导信息,可能成为错误的注释。因为代码本身和后面程序中的注释将起到相应的说明作用。
过程中的注释块应该包括如下标题:
小节 描述内容
目的 该过程完成什么
假设 列出每个外部变量、控件、打开文件或其他不明显元素
效果 列出每个被影响的外部变量、控件或文件及其作用(只有当它不明显时)
输入 每一个可能不明显的参数。
返回 函数返回值的说明
格式化代码
(1)标准的,基于制表位的嵌套应该包括一个嵌注释,来描述该变量的使用。
(2)变量、控件及过程
您可能关注的文档
- 综合交通的规划设想最终-.doc
- 综合办公楼工程冬季施工的方案.doc
- 统治世界10个符号与它们神秘起源.doc
- 综合写字楼管理的方案.doc
- 综合勘探技术在曹家滩井田勘探中应用.doc
- 综合文化的知识试题样题-.doc
- 综合服务区土地整理工程二号路两侧施工的的总结.doc
- 综合楼施工的方案典尚的设计三维动画效果图.doc
- 综合活动的设计.doc
- 综合楼钢筋施工的方案.doc
- 医学检验与临床诊疗的突破.pptx
- 科技企业专利布局策略优化与2025年知识产权战略布局研究报告.docx
- 2025年家居用品电商本土化营销创新模式研究报告.docx
- 线上职业技能认证跨境培训平台在2025年国际化发展策略研究报告.docx
- 2025年家居用品电商本土化营销策略与市场定位研究.docx
- 阿斯利康医药市场准入策略与药品市场准入政策实施路径研究报告.docx
- 2025年家居用品电商本土化营销内容营销策略与实施报告.docx
- 2025年新能源发电项目市场可行性评估报告.docx
- 2025年家居用品电商本土化营销策略与市场细分及品牌传播研究.docx
- 2025年家居用品电商本土化营销策略与市场细分报告.docx
文档评论(0)