欢迎来到天天文库
浏览记录
ID:25839158
大小:148.00 KB
页数:14页
时间:2018-11-23
《pb编程规范41257》由会员上传分享,免费在线阅读,更多相关内容在教育资源-天天文库。
1、编程规范(PB)1简介1.1简介这个文档描述了用于编写稳定、可靠的PowerBuilder应用程序的一些标准、约定和准则。他们基于合理的,经过证实的一些使代码容易理解、维护和增强的软件工程的原则。另外,遵循这些标准,你作为一个PowerBuilder程序员的生产力将有一个显著的提高。一些经验证明,花时间在项目的开始写出高质量的代码,可以使在后来的开发过程中容易修改它,从而事半功倍。最后,遵循这一系列编码规范,可以使一个开发团队更好地保持一致性,最终必将极大地提高团队的生产力。1.2最初的准则和最终的准则当你无法找到一些你需要的原则或准则时,或者它们很明显地
2、不适用,或者其它的一些情况下,请使用常识,按照一些基本的原理去作。这个原则凌驾于其他原则。2命名规范2.1一般性约定1.使用英文或汉语拼音的全称去准确地描述各种对象、变量例如,ls_UserName(用户名),ldc_GrandTotal(总计)等等。尽管x1,y1这样的名称很容易拼写,因为它们很短,但是他们不可能明确地提示名称的含义,将导致代码难以理解、维护和改进。2.使用大小写混合的方式命名3.以合适的方式使用缩写例如ll_RownNmber,简写为ll_RowNum是可以理解的,但是li_ReturnCode简写为li_rc就不一定被别人看懂,所以应
3、该以尽量保守的态度使用缩写,在更多的时候使用全称,或者建立常用缩写的对照表。4.避免太长的名称,尽量限制在15个字母以内长名称虽然很容易懂,但特别长将导致拼写时经常出错。5.不要在第一个字母和最后一个字母使用下划线6.保持命名的一致性。相关的东西应给以相关的名字,以说明他们的关系和差异1.1具体约定1.1.1对象命名规范<前缀>_名称前缀说明m菜单(Menu)n标准用户对象(Standardclassuserobject)n_cst定制用户对象(Customclassuserobject)u可视用户对象(Visualuserobject)d数据窗口(Dat
4、awindow)w窗口(Window)s全局结构(Globalstructure)注:名称为英文,新建对象必须加注释(菜单对象可例外)。一般情况下,菜单对象的名称与其所属窗口的名称一致。例子:w_master,m_master,d_cig_cdu_tvsistheTreeViewvisualuserobjectu_dwistheDataWindowvisualuserobjectn_cst_dwsrvisthecustomclassuserobjectforDataWindowservicesn_tristhetransactionstandardclas
5、suserobjectandisintheextensionlevel1.1.2变量范围命名规范<范围><数据类型>_变量名范围:范围说明a事件或函数的参数(Argumenttoaneventorfunction)g全局变量(Globalvariable)i实例变量(Instancevariable)l局部变量(Localvariable)s共享变量(Sharedvariable)对于标准数据类型:数据类型说明aAnyblbBlobbBooleanchCharacterdDatedtDateTimedcDecimaldblDoubleeEnumerated
6、iIntegerlLongrRealsStringtmTimeuiUnsignedIntegerulUnsignedLong例子:as_unitcode表示事件或函数的输入参数,string类型idc_val表示实例变量,decimal类型li_row表示局部变量,integer类型gd_firstday表示全局变量,date类型对于常用参照数据类型(referencevariables):数据类型说明dsDataStoredwDataWindowdwcDataWindowChilddwoDwobjectlviListViewItemmmMailMessa
7、gemrMailRecipientmsMailSessionstrStructuretrTransactiontvTreeViewtviTreeViewItemwWindow例子:datastorelds_unitDataWindowChildldwc_cigwindowlw_code注:1)尽量避免使用全局变量。2)全局变量和实例变量必须加注释(说明该变量在何处设置和使用);重要的局部变量加注释4)全局变量使用具有说明性(名字足够长)的名字,局部变量用短名字5)按常规方式使用的局部变量可以采用极短的名字。例如:用i、j作为循环变量例如:在window的o
8、pen()事件中对统计日期id_date赋值,在dw_unit.i
此文档下载收益归作者所有