- 1、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。。
- 2、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
- 4、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
- 5、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们。
- 6、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 7、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
良好的编程习惯
良好的习惯对于人的成长是非常重要的,良好的编程习惯对于我们编程能力的提高也是非常重要的。我们编程时要有良好的风格,源代码的逻辑简明清晰,易读易懂是好程序的重要标准。
其实编程的过程中最容易忽略的还是程序的“风格”这些东东有时让人挺烦的,刚刚放射出光茫的思想似乎被约束住了,本来是灵感发现,还要在后面罗索上半天。
程序需要风格吗?让我们的程序写得更加平易近人,更加生动对我们的编程是大有益处的。对我们的程序学习也能起到事半功倍的作用。编程过程中遵守的不成文的标准,对于我们和他人的交流和自己的再学习都是有益无害的。毕竟有时我们写的程序不是只给自己看的,也不是一时兴起,不管以后。好的编码可使源代码的可读性强且意义清楚与其他语言约定相一致,并且尽可能直观。我们自己一眼能看出个大概,在别人眼中也不至于成为千古奇书。下面以VB为例,对程序风格做一下全面的概述,希望对您的编程水平的提高有所帮助。
一、程序内部文档应具备的规则
1、标识符应含有含义鲜明的文字。
含义鲜明的文字,能正确地提示程序对象所代表的实体这对于帮助阅读者理解程序是非常重要的。如果用缩写的形式,那么缩写规则应该一致,并且应该给每个名字加注解在VB中,主要有如下的约定:
(一) 对象命名约定
应该使用一致的前缀来命名对象,使人们容易识别对象的类型。例如我们常用控件CommandButton命令按钮)可用cmd做为其前缀Form以frm,Image以img,Label以lbl,ListBox以lst,PictureBox以pic,Timer以tmr,等等,在我们编程的过程中,我们看到下面的名称cmdExit我们就知道这一定是一个命令按钮了。如果是第三方提供的控件,我们的说明最好要清晰地标出制造商的名称,以区别于我们的常用控件。
(二) 常量和变量命名约定
除了控件以外,常量和变量也是我们编程过程中经常遇到的我们和他们打交道也是通过名字。
(1)给变量加范围前缀
变量按其作用范围可分做三类,过程级,模块级和全局,所以我们在编程的过程中应将三者加以区别。我们在使用变量时,为了更好地体现代码重用和可维护原则,其定义范围应尽量缩小,这样将使我们的应用程序更加容易理解和易于控制在VB应用程序中,只有当没有其他方便途径在窗体间共享数据时才使用全局变量。当使用全局变量时,在一个单一模块中声明它们,并按功能分组,给模块取一个有意义的名字。较好的编码习惯是尽可能地定模块化的代码。除了全局变量,过程和函数应该仅对传递给它们的的对象操作。在过程中使用的全局变量应该在过程起始处的声明部分标识出来。变量的作用范围前缀如下:全局g(global),模块级m(model),本地过程不需要使用。例如:gintFlag,表示全局整型变量,mstrPassword,可表示模块级字符型变量。
(2) 声明所有变量原则。声明所有变量将会节省编程时间,键入错误将大大减少,我们可在程序开始写上如下语句:
OptionExplicit
该语句要求在程序中声明所有变量。
(3) 变量数据类型声明。可通过下面的前缀来做为变量的数据类标志。
Booleanbln
Bytebyt
Doubledbl
Integerint
Stringstr
(4) 常量。常量的命名,可遵循与变量命名大体相同的原则。
(5) 对变量和过程名作出描述。变量或过程名的主体应该使用大小写混合的形式并且应该足够长以描述它的作用。而且,函数名应以一个动词开头。如dgeDialog.
2、 适当的注解
注解是程序员和程序读者通信的重要手段,正确的注解非常有助于对程序的理解。中代码注解约定如下:所有的过程和函数都应该以描述这段过程的功能的一段简明的注释开始,说明该程序是干什么的,至于是如何做的,也就是编程的细节,最好不要包括。因为可能日后我们要修改程序,这样做会带来不必要的注释维护工作,如果不修改,将提供误导信息,可能成为错误的注释。因为代码本身和后面程序中的注释将起到相应的说明作用。
过程中的注释块应该包括如下标题:
小节描述内容
目的该过程完成什么
假设列出每个外部变量、控件、打开文件或其他不明显元素
效果列出每个被影响的外部变量、控件或文件及其作用(只有当它不明显时)
输入每一个可能不明显的参数。
返回函数返回值的说明
格式化代码
(1) 标准的,基于制表位的嵌套应该包括一个嵌注释,来描述该变量的使用。
(2) 变量、控件及过程的命名应该足够清楚,使得只有复杂的执行细节才需要嵌入注释。
(3) .bas模块包含包含工程的VB一般常量声明,在其起始处,应包括程序的综述,列举
主要数据对象,过程、算法、对话、数据库及系统需求。
3、 程序的视觉组织
程序的视觉组织可用
您可能关注的文档
最近下载
- 华南理工大学《土力学》2021-2022学年第一学期期末试卷.doc VIP
- 电力电缆安装运维工职业技能竞赛考试题库大全-下(多选、判断题汇总).docx VIP
- 战场救护知识培训PPT课件.pptx VIP
- 在线网课学习课堂《人工智能原理》单元测试考核答案.docx VIP
- 2025年大学生学术研究洞察报告.docx VIP
- 比亚迪G3维修手册F3电器组.doc VIP
- 统编版高中历史必修中外历史纲要下册知识点复习提纲详细版(实用,必备!).docx VIP
- 《王二小的故事》课件PPT[一].ppt VIP
- 2024届高校毕业生就业蓝皮书.pptx VIP
- 2024中国留学生归国求职洞察报告第二期.pdf VIP
原创力文档


文档评论(0)