编码规范1
工程项目编码规范(制度版)
水务事业部管理制度工程项目编码规范XXXX-XX-XX发布XXXXXXX XXXX-XX-XX 修订实施(发布日期)(文件编制部门)(修订实施日期)工程项目编码规范1、目的1.1为规范水务事业部工程项目管理信息行为,提高工程项目代码信息质量,通过工程项目代码实现各系统信息数据共享和有效连接,实行工程项目统一编码,特制定本规范。
1.2为达到以上目的和简化流程,科技项目编码也纳入本规范,不再另作规定。
2、适用范围本规范适用于中山市供水有限公司、中山市污水处理有限公司及各下属分公司、全资子公司、控股子公司,参股公司可参照执行。
3、编码对象及使用规则3.1编码对象包括工程建设项目和科技项目。
3.1.1内部投资形成公司资产的生产性工程项目(包括管网工程项目和生产性基建项目)、非生产性工程项目。
3.1.1.1管网工程项目:给排水管及相关给排水设施新(扩)建、改造安装工程。
3.1.1.2生产性基建项目:生产性基建设施(包括水厂)新(扩)建、改造工程。
3.1.1.3非生产性基建项目:非生产性基建设施新建、改造(主要是指装饰装修)工程。
3.1.2对外承接收费的水表安装工程(如新装、换装水表)、表前管安装工程;表后管安装工程(如二次供水工程)和相关维修工程等。
3.1.3公司投资的科技项目:信息和自动化技术应用开发项目;技术研究与开发项目;应用理论及应用基础研究项目;科技成果转化项目,包括商品化开发、重大中间试验、示范工程项目;技术前期及可行性研究项目和工艺改造项目。
3.2工程项目代码按以下分类方式赋码,项目代码在使用过程中保持唯一性和不变性。
3.2.1内部投资工程由投资所属地区公司工程立项部门负责赋码,其中A类工程项目代码由投资所属地区公司(或城区本部B类工程立项部门)提供给水务部技术部(A、B分类按照水务事业部现行的《工程项目管理制度》执行)。
3.2.2外接收费工程首先在营业收费系统设定编码程序,在客户服务中心服务窗口(或客户服务中心开放给工程管理部门的营业收费系统端口)受理时直接赋码。
企业内部编码设置规范
企业内部编码设置规范(一).企业内部商品代码编码1.采用EAN-128码编制2.企业内部商品代码的设置结构(共13位)X X X XXXXX XXX XX品牌年份(季节)产品款号颜色尺码(1位)(1位)(1位)(5位)(3位)(2位)(二).品牌编码方法采用1位数进行编码1:代表*****,2:代表****(三).年份编码方法采用1位数进行编码1:代表2011年2:代表2012年3:代表2013年……(四).季节、波段编码方法采用1位数进行编码1:代表春季第1波段2:代表春季第2波段3:代表夏季第1波段4:代表夏季第2波段5:代表秋季第1波段6:代表秋季第2波段7:代表冬季第1波段8:代表冬季第2波段(五).产品款号编码方法采用5位数进行编码。
具体设定的产品分类方案如下:AA、首位数是“0”代表T恤类。
第2位数代表该类产品的各小类区分,如下:0:代表长袖圆领T恤1:代表长袖V领T恤2:代表长袖翻领T恤3:代表长袖立领T恤4:代表短袖T恤5:代表短袖V领T恤6:代表短袖翻领T恤7:代表短袖立领T恤8:代表短袖开恤A、首位数是“1”代表衬衫类。
第2位数代表该类产品的各小类区分,如下:0:代表长袖休闲衬衫1:代表长袖商务衬衫2:代表短袖休闲衬衫3:代表短袖商务衬衫B、首位数是“2”代表毛线衫类。
第2位数代表该类产品的各小类区分,如下:0:代表长袖圆领毛衫1:代表长袖V领毛衫2:代表开衫3:代表长袖翻领毛衫4:代表长袖立领毛衫5:线衫背心6:代表短袖圆领毛衫7:代表短袖V领毛衫8:代表短袖立领毛衫9:代表长袖翻领毛衫C、首位数是“3”代表外套类。
第2位数代表该类产品的各小类区分,如下:0:代表茄克1:代表棉服2:代表羽绒3:代表马甲4:代表皮衣5:代表棉西6:代表风衣7:代表休闲服8:代表昵大衣9:代表棉楼0:代表尼克服D、首位数是“4”代表西服类。
第2位数代表该类产品的各小类区分,如下:0:代表套西1:代表正装单西服2:代表韩牌便西E、首位数是“5”代表毛衣类。
软件开发规范:编码规范
软件开发规范:编码规范C#编码规范目标:1. 安全:代码完成所需的功能之余,不要产生负作用,即要稳定可靠。
2. 易读: 类、实例、成员变量、成员函数的命名一目了然3. 美观: 尽量统一项目组内人员的编程风格。
第一部分:命名1. 命名原则1) 所有的函数(变量/类/文件名)应该代表其实际的作用,应该使用有意义的单词或多个词组合,但不要使用人名、项目组名。
2) 所有的函数(变量/类名)一律使用英文。
3) 使用多个单词时不需要使用连线(如下划线), 但对于全部大写的宏需要使用连线。
4) 多个词组合较长时, 可以使用单词的缩写。
5) 不得使用非常相近的名字类表示几个不同含义的函数(变量/类)。
6) 命名时请考虑名字的唯一性和含义的准确性。
7) 使用项目组专用词汇来表达特定的含义(概念), 不得把专用词汇挪作他用。
2. 变量的命名原则: 使用匈牙利命名法命名变量1) 变量名一般由“类型修饰+代表变量含意的英文单词或单词缩写”等部分组成。
类型修饰(小写字母):n: int,l: LONG/long, s: short,u: UINT,f: floatb: bool,by: BYTE,ch: char, sz: char[],str: string2) 针对异常捕获过程中的 Exception 变量命名,在没有冲突的情况下,统一命名为e;如果有冲突的情况下,可以重复 e,比如:ee。
3. 函数的命名1) 使用动宾词组表达函数实际所作的事。
2) 同名的函数(重载函数)在功能上应该完全相同, 在参数上的差别也应一目了然。
3) 不得出现名字非常相近但功能不同的函数. 如 CreatePage1(), CreatePage2()等。
4. 类命名1) 名字应该能够标识事物的特性。
2) 名字尽量不使用缩写,除非它是众所周知的。
3) 名字可以有两个或三个单词组成,但通常不应多于三个。
4) 在名字中,所有单词第一个字母大写,缩写都要大写。
常用电子料 物料编码与规格描述规范 1(阳志强))
第8页
Shenzhen PYS Industrial Co., LTD
深圳市鹏元晟实业有限公司 Shenzhen PYS Industrial Co., LTD
Shenzhen PYS Industrial Co., LTD
2.电子材料的规格描述,需依“物料编码规则”要求填写内容。 2.1贴片电阻的规格描述的顺序,如下所示:
a
bc d
e
f
g
h
I
a: 名称
b: 电感量 (单位: 钠亨(nH)、微亨(uH)、毫亨(mH)、亨(H))
c: 允许偏差(±1% 、±2% 、±5%、±10% 、±20%)
d: 元件尺寸(L*W*H; 单位: mm)
e: 直流电阻
f: 额定电流(单位:毫安(mA)、安培(A))
g: 供应商型号
h: 供应商(可选择内容)
h: 环保要求(ROHS)
第9页
Shenzhen PYS Industrial Co., LTD
深圳市鹏元晟实业有限公司 Shenzhen PYS Industrial Co., LTD
Shenzhen PYS Industrial Co., LTD
2.2贴片积层电容的规格描述的顺序,如下所示:
例:贴片电容 1206 X7R 470NF ±10% 50V TDK 符合ROHS
例: 贴片电阻 0805 560Ω ±5% 1/10W 150V YAGEO 符合ROHS
a
bc d e f
g
h
a: 名称
b: 封装形式(0201/0402/0603/0805/1206/1210/1812/2010/2512; 单位: inch)
PDU编码规则1
B:短信息中心号码类型,2位十六进制数。
C:短信息中心号码,B+C的长度将由A中的数据决定。
D:文件头字节,2位十六进制数。
E:信息类型,2位十六进制数。
F:被叫号码长度,2位十六进制数。
G:被叫号码类型,2位十六进制数,取值同B。
H:被叫号码,长度由F中的数据决定。
C8 32 9B FD 0E 01 用户信息(TP-UD) “Hello!”
例2 接收:SMSC号码是+8613800250500,对方号码是13693092030,消息内容是“你好!”。手机பைடு நூலகம்收到的PDU串可以是
08 91 68 31 08 20 05 05 F0 84 0D 91 68 31 96 03 29 30 F0 00 08 30 30 21 80 63 54 80 06 4F 60 59 7D 00 21
I:协议标识,2位十六进制数。
J:数据编码方案,2位十六进制数。
K:有效期,2位十六进制数。
L:用户数据长度,2位十六进制数。
M:用户数据,其长度由L中的数据决定。J中设定采用UCS2编码,这里是中英文的Unicode字符。
PDU编码协议简单说明
例1 发送:SMSC号码是+8613800250500,对方号码是13693092030,消息内容是“Hello!”。从手机发出的PDU串可以是
对照规范,具体分析:
分段 含义 说明
08 地址信息的长度 个八位字节(包括91)
91 SMSC地址格式(TON/NPI) 用国际格式号码(在前面加‘+’)
68 31 08 20 05 05 F0 SMSC地址 8613800250500,补‘F’凑成偶数个
【制度编号】管理制度编码规范
公司制度编码规范1 适用范围本规范适用于公司制度的编码管理工作。
对于法律法规、上级政令、国家标准等可直接应用于生产及经营管理环节的各类外部制度,不在此编码管理的范围。
2 术语和定义制度及制度门类代号定义如下:制度:是具有一定结构的规则集合。
本文所称制度是指公司制定的各类业务处理规范的总称,包括技术标准、管理制度、岗位标准、作业标准等。
技术标准:对公司系统需要协调、统一的技术事项所制定的标准,范围包括技术规定、技术规范、验收规范、技术规程、技术导则等。
管理制度:是指公司各部门、单位根据职责或业务管理需要起草并发布的业务处理规范性文件。
范围包括除“技术标准、岗位标准、作业标准”以外的“规定”、“办法”、“细则”、“规则”、“标准”等,管理标准属管理制度的范畴。
岗位标准:对岗位职责需要统一协调的工作事项所制定的标准,范围包括岗位规范说明书或岗位责任书等。
作业标准:主要是为规范员工操作而制定的,为保证重要工作过程的质量及安全而制定的具体作业活动程序文件,范围包括作业指导书、作业表单等。
3 职责公司战略策划部为制度编码的归口管理部门,负责确定制度门类代号和制度分类号,制度序号由制度管理技术支持系统实现自动生成。
各分子公司企业管理部门为本单位制度编码的归口管理部门。
4 制度编码规则制度的编码执行如下规则,并可根据需要作相应扩展。
Q / CSG ××××××—××××发布年号制度序号制度分类号制度门类代号南方电网公司企业代号企业标准代号公司制度编号采用分段式,Q为表企业标准代号,CSG为中国南方电网有限公司(CHINA SOUTHERN POWER GRID)企业代号,后根据需要可加各分子公司代号(如超高压公司:CSG-EHV)。
编号统一为Q/CSG ××××××-××××,CSG后一位数字为门类代号,1代表技术标准、2代表管理制度、3代表岗位标准、4代表作业标准,第二、三位数字为制度分类号(见附录,可根据需要扩展),第四、五、六位数字为制度序号(可扩展),最后四位为发布年号。
python编码规范(一)——空格的使用
python编码规范(⼀)——空格的使⽤1.概述
在python代码中,需要加空格的⼀共有四个地⽅需要特别注意。
即⼆元运算符,逗号,冒号,#号
2.逗号
逗号后⾯要加空格,但是如果后⾯是⼩括号,则不⽤
# 逗号
func = (0,)
x, y = y, x
print x, y
3.冒号
冒号前不加空格,冒号后要加空格,但在切⽚⾥,前后都不⽤加空格
spam(ham[1], {eggs: 2})
if x == 4: print x, y; x, y = y, x
ham[1:9], ham[1:9:3], ham[:9:3], ham[1::3], ham[1:9:]
4.#号
井号需后要加⼀个空格
# 注释
5.⼆元运算符
⼆元运算符前后,都要加空格,但作为函数参数时=前后不⽤加空格
如果使⽤具有不同优先级的运算符,只在具有最低优先级的运算符周围两边添加空格,其它的就不⽤加了。
i = i + 1
sum += 1
x = x*2 - 1
max = x*x + y*y
c = (a+b) * (a-b)
6.其他
除了以上四种情况外,其他地⽅,请谨慎使⽤空格。
编码规范要求
编码规范要求篇一:编码规范中中实智达开发规范文档修改记录1、概述1、1 目的在软件的生命周期中,维护的花费通常占很大的比例,且几乎所有的软件,在其整个生命周期中,开发人员和维护人员都不尽相同。
编码规范可以改善软件的可读性,使程序员尽快而彻底地理解代码;同时,编码规范还可以提高程序代码的安全性和可维护性,提高软件开发的生产效率,所以,编码规范对于程序员而言至关重要。
为使开发项目中所有的 JAVA程序代码的风格保持一致,增加代码的可读性,便于维护及内部交流,使 JAVA程序开发人员养成良好的编码习惯,有必要对 JAVA程序的代码编码风格做统一的规范约束。
本文档定义了我公司软件开发过程中使用的开发语言的编码规范,指导软件开发人员在进行项目开发过程中提高代码质量、统一编码要求。
1.2适用范围除客户方另有特别要求外,适用于 JAVA、JSP、Servlet等项目的开发。
2、JAVA源文件2.1、PACKAGEPackage是组织相关类的一种比较方便的方法。
Package使我们能够容易查找和使用类文件,并可以帮助我们在运行程序时更好的访问和控制类数据。
类文件可以很容易的组织到 Package中,只要把相关的类文件存放到同一个目录下,给该目录取一个与这些类文件的作用相关的名称。
如果需要声明程序包,那么每个 JAVA文件(*.java)都需要在顶部进行 Package的声明,以反映出包的名称。
例:package .meritit.product.modul.dao;2.2 JAVA源文件的内部结构2.2.1 Package/ImportPackage行要在 import行之前,import中标准的包名要在本地的包名之前。
如果 import行中包含了同一个包中的不同子目录,应import到某一个指定的类,避免*类型的 import。
(导包:Ctrl+Alt+O)例:package .meritit.product.modul.dao;import java.io.*;(不提倡,应该避免)import java.io.InputStream;import java.io.OutputStream;2.2.2Class所有的 JAVA(*.java)文件都应遵守如下的样式规则,如果JAVA源文件中出现以下相应的部分,应遵循如下的先后顺序。
物料分类编码管理规程1
目的:建立物料分类编码管理规程,使物料的管理规范化,避免差错发生。
范围:适用于公司所使用的原料、辅料、包装材料、中间产品、成品及化学试剂的统一编码。
责任:仓库管理人员、仓库保管员、车间操作工及化验员。
内容:1.原料、辅料、包装材料、中间产品、成品及化学试剂均应纳入物料分类编码系统,对全部进行统一编码。
2.编码应能表示出物料分类、品种规格到货时间及累讣批次,每批物料只能有一个专一性的编码,物料编码不能随意更改变换。
3.物料分类编码的编制:3.1物料分类及代号:3. 1. 1物料代码:3.1.2类别代码:3. 1.2. 1 原料(Y):3. 1.2.2 辅料(F):3. 1.2.3包装材料(B):3. 1. 2. 4中间产品::3. 1.2.5 成品(C):3. 1.2.6化学试剂(H):3. 1. 3品种代码3.1.3. 1 药材Y(J):3. 1.3.2西药代码(YX):3. 1.3.3辅料代码(F):3. 1.3. 4产品代码:C3. 1.3.5中间产品3. 1.3.6化学试剂(H):3. 2物料分类编码格式:物料代码+类别代码+品种代码一顺序码+流水号物料代码:为一位大写字母。
如:Y(原料)/F (辅料)/B (包装)/Z (中间产品)/C (成品)/H (化学试剂)类别代码:为一位大写字母或两位数字。
如:J (净料药材)、01 (说明书)或G(固体)。
品种代码:为三位数字组成。
如:001 (丁香)、001 (八珍益母丸)。
如:YZ001-130501中药原料丁香2013年5月购进第一批B01001-130501包装材料八珍益母丸说明书2013年5月购进第一批4我公司现行原料、辅料、包装材料、中间产品、成品和化学试剂的分类编码为“物料分类编码”。
5每种物料的编码具有唯一性,不得更改,不得因为长期不用而删除。
6新增物料编码时,山申请人提出申请,并山仓库依据编制方法要求增加编号,并上报质量管理部批准。
java编码规范(建议稿,修改自华为规范) (1)
武汉中软卓越科技有限公司Java语言编码规范Table of Contents 目录1. 范围 (3)2. 术语和定义 (3)3. 排版规范 (4)3.1. 规则 (4)3.2. 建议 (6)4. 注释规范 (7)4.1. 规则 (7)4.2. 建议 (12)5. 命名规范 (14)5.1. 规则 (14)5.2. 建议 (15)6. 编码规范 (17)6.1. 规则 (17)6.2. 建议 (20)7. JTEST规范 (22)7.1. 规则 (22)7.2. 建议 (23)1.范围本规范规定了使用Java语言编程时排版、注释、命名、编码和JTest的规则和建议。
本规范适用于使用Java语言编程的案例、产品和项目。
2.术语和定义规则:编程时强制必须遵守的原则。
建议:编程时必须加以考虑的原则。
格式:对此规范格式的说明。
说明:对此规范或建议进行必要的解释。
示例:对此规范或建议从正、反两个方面给出例子。
3.排版规范3.1.规则3.1.1.*程序块要采用缩进风格编写,缩进的空格数为4个。
说明:对于由开发工具自动生成的代码可以有不一致。
3.1.2.*语句块分隔符左括号‘{’应与语句块引用代码在同一行,右括号‘}’应另起一行并与语句块引用代码左对齐。
在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。
示例:如下例子不符合规范。
for (...){... // program code}if (...){... // program code}void example_fun( void ){... // program code}应如下书写:for (...){... // program code}if (...){... // program code}void example_fun( void ){... // program code}3.1.3.*较长的语句、表达式或参数(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。
编码规范
编码规范代码必须符合Java的编码规范。
Java的编码规范包括:命名规范(1)所有的标识符都只能用ASCII字母(A~Z或a~z)、数字(0~9)和下划线“-”。
(2)一个唯一包名的前缀总是全部小写的字母。
例如:ng.util。
(3)类名是一个名词,采用大小写混合的方式,每个单词的首字母大写。
例如:Customer、CreditAccount。
(4)接口的大小写规则与类名相似。
例如:Contactable、Prompter。
(5)方法名是一个动词或动词词组,采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写。
例如:setFirstName(String firstName)、assignrole(SysUseruser)。
(6)变量名第一个字母小写,任何中间单词的首字母大写。
变量名应简短可以顾名思义,易于记忆。
例如:firstName, userAddress。
避免单个字符的变量名,除非是一次性的临时变量。
(7)常量的声明应该全部大写,每个单词之间用“-”连接。
例如:MIN_BALANCE、USER_STA TUS_NORMAL。
注释规范(1)注释尽可能使用“//”;对于所有的javadoc的注释则用“/** */”;而临时对代码块进行的注释尽量用“/* */”。
(2)所有的源文件都应该在开头有一个注释,其中列出文件名、日期和类的功能概述。
(3)每个方法必须添加文档注释(类的main()方法除外)。
(4)每个属性必须添加注释。
(5)代码中至少包含15%的注释。
(6)注释使用中文。
缩进排版规范(7)避免一行的长度超过60个字符。
(8)使用Eclipse的源代码的格式化功能完成代码的缩进排版。
文件名规范(9)一个Java源文件只能存储一个Java类。
(10)文件名与Java类名相同(11)一个类文件的代码行不超过200行。
声明规范(12)一行声明一个变量。
(13)不要将不同类型变量的声明放在同一行。
编码规范
排版风格<规则 1>程序块采用缩进风格编写,缩进为4个空格位。
排版不混合使用空格和TAB键。
<规则2>在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如->),后不应加空格。
<规则3>函数体的开始,类的定义,结构的定义,if、for、do、while、switch及case语句中的程序都应采用缩进方式," { " 独占一行并且位于同一列,同时与引用它们的语句左对齐, 示例:for ( ... ){... // 程序代码}<规则4>功能相对独立的程序块之间或for、if、do、while、switch等语句前后应加一空行。
<规则5>if、while、for、case、default、do等语句自占一行。
示例:if( pUserCR == NULL ){return;}<规则6>若语句较长(多于80字符),可分成多行写,划分出的新行要进行适应的缩进,使排版整齐,语句可读。
<规则7>一行最多写一条语句。
<规则8>不同类型的操作符混合使用时,使用括号给出优先级。
注释<规则1>程序在必要的地方必须有注释,注释要准确、易懂、简洁。
<规则2>注释应与其描述的代码相近,对代码的注释应放在其上方或右方(对单条语句的注释)相邻位置,不可放在下面,如放于上方则需与其上面的代码用空行隔开。
<规则3>函数头部应进行注释。
编码规范
6、类的成员变量使用“m_”做前缀。之后的首单词小写。第二单词开始的规范同结构体的成员变量。
7、函数名首字母小写,第二单词开始首字母大写,或字母间使用下划线。
(但同一文件中只能使用其中一种)
7、if/else 后的语句如果和 if/else 在同一行可以省略大括号,否则必须加大括号。
1、代码要尽量整洁
2、缩进使用tab,不能使用空格,编辑器的tab都调到4字符宽。
3、所有的结构体全部使用大写字母,单词间用下划线“_”分隔。
4、所有的类使用各单词首字母大写。
5、全局变量使用“g_”前缀,文件内静态变量使用“s_”前缀。
5、结构体的成员变量一律小写。第二单词开始首字母大写,或字母间使用下划线。
13、类型、类、输出函数、全局变量,必须有注释,说明用途、用法。
程序中主要的步骤、算法等也要加注释说明。
14、每个文件开头要有文件说明、文件的作者、创建时间。
重要维护或者更换了维护人之后要增加维护记录。
文件除了文件头中声明的人报warnning)
9、变量、类型、函数取名时要有意义,要易懂。
类型名、变量名应该是名词或名词性短语,函数名应该是动词或动宾短语。
10、编译时warnning都要消除。
11、函数不得过长,不得超过100行,尽量控制在1屏左右。
12、代码的一行不得过长,应该控制在80到100字符左右,超出后应该折行。
编码规范
编码规范1 命名规约1.1 数据库对象命名规约1.1.1 表名均采用Tab-前缀+单数英文名词表示,不加空格,每个词的首字母大写。
表示单个实体的表名:TabXxxx——XXXX为实体英文单词,例如:员工信息表——TabEmployee;表示两个实体关系的表名:TabXxYy——XxYy为实体汉语拼音声母字母,例如:项目课程信息表——TabProjectCourse。
1.1.2 视图名均采用View-前缀+视图主要内容或基表名称构成,其他约定同表名。
1.1.3 存储过程名均采用Proc-前缀+存储过程主要用途名称构成,其他约定同表名。
1.2 WinForms窗体与控件对象命名规约1.2.1 窗体名:均以frm-为前缀,采用英文单词表示,每个词的首字母大写。
临时窗体名:frm+使用者+用途。
例如:前台登录窗体——frmWaiterLogin。
主界面窗体名:frmMain+使用者。
例如:前台主界面窗体——frmMainWaiter。
1.2.2 控件名:均以前缀+用途或内容的英文单词表示,每个词的首字母大写。
TextBox控件:前缀为txt-,例如:用于输入用户名的TextBox——txtUserName。
Label控件:前缀为lbl-。
Button控件:前缀为btn-。
ComboBox控件:前缀为cmb-。
CheckBox控件:前缀为chk-。
RadioButton控件:前缀为rad-。
DataGrid控件:前缀为grd-。
MainMenu控件:前缀为mmu-。
ContextMenu控件:前缀为cmu-。
子菜单项:mu+菜单项名+子菜单项用途,例如:“文件”菜单中的“退出”项——muFileExit。
1.3 C# 类名与变量名命名规约1.3.1 类名:均以Cls-为前缀。
1.3.2 类数据成员名:私有变量均以下划线“_”为前缀,首字母小写。
1.3.3 变量名:1.3.3.1 基本类型变量以变量类型的缩写为前缀,首字母小写。
公司物料编码规范
唐山恒联机电设备有限公司受控文件《物料编码规范》执行日期:目录一、编码体系设计原则 (1)二、公司物料编码段、位数设定 (2)三、公司物料编码取值说明 (3)(一)D电器类 (3)(二)Z自动化类 (5)(三)F辅料类 (6)(四)G柜体类 (7)(五)Y仪表类 (9)(六)C产品类 (12)物料编码是以简短的文字、符号或数字、号码来代表物料、品名、规格或类别及其它有关事项的一种管理工具。
在物料极为单纯、物料种类极少的工厂或许有没有物料编码都无关紧要,但在物料多到数百种或数千、数万种以上的工厂,物料编码就显得格外重要了。
此时,物料的领发、验收,采购、盘点等工作极为频紧,而借着物料编码,使各部门提高效率,各种物料资料传递迅速、意见沟通更加容易。
物料编码是公司对于物料进行科学有效管理的依据,是公司最重要的基础数据一、编码体系设计原则:1、唯一性保证编码的唯一性,是编码的根本原则,同一种物料只能对应一个编码,同一编码只能代表一个物料,绝不能出现一个物料多个编码,或多个物料的情况。
对于同种物料,不同供应商提供时,应在编码中能够有所体现,以便区别并对物料进行追溯。
2、通用性同一编码原则应能涵盖大多数物料,新增加的品种也能够适应。
3、使用性不宜过长,便于使用,容易记忆。
4、扩展性便于追加,追加后不引起体系混乱。
5、效率性适宜计算机处理、适宜快速录入、适宜辨认。
6、可读性物料编码不一定要求一看就知道是哪种物料,但应当做到一看到物料就能够识别出该物料是属于哪一类的物料,采用前段用分类码,后段用顺序码的方式进行编码。
编码的使用者应可以在较短的时间内对编码的方式有大致的了解。
二、公司物料编码段、位数设定公司物料编码分为八段,共计18位(含两位分隔符),即:x x xx xx-xxxxxx-xxxx。
具体码段分配数字位数如下表所示:说明:(1)物料的主参数(例中为电流)用分隔号隔开,目的是便于快速看清产品的主参数,便于快速分类和检索。
初识C语言编码规范
C语言编码规范1-排版规则程序应采用缩进风格编写,每层缩进使用一个制表位(TAB),类定义、方法都应顶格书写;源程序建议使用英文书写,尽量不含有中文。
每行不超过80字符。
对于较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读;循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分;左花括号要另起一行,不能跟在上一行的行末;一个变量定义占一行,一个语句占一行;对独立的程序块之间、变量说明之后必须加空行;在结构成员赋值等情况,等号对齐,最少留一个空格;若函数或过程中的参数较长,则要进行适当的划分。
形参的排序风格:最常使用的参数放在第一位;输入参数列表应放在输出参数列表的左边;将通用的参数放在特殊的参数的左边。
2-命名规范应用程序的命名“系统简称”+模块名称子模块的命名每个子模块的名字应该由描述模块功能的1-3以单词组成。
每个单词的首字母应大写。
在这些单词中可以使用一些较通用的缩写。
变量的命名变量的命名的基本原则是使得变量的含义能够从名字中直接理解。
可以用多个英文单词拼写而成,每个英文单词的首字母要大写,其中英文单词有缩写的可用缩写;变量的前缀表示该变量的类型;对于作用域跨越10行以上的变量名称不能少于4个字符,除循环变量,累加变量外不得使用I、j、k等名称的变量。
变量分为取全局变量和局部变量,对于全局变量以加前缀“g_”来区分。
使用有意义的英语单词,使用大小写分隔,每个单词的第一个字母为大写考虑到习惯性和简洁性,对于按常规使用的局部变量允许采用极短的名字,如用n、i作为循环变量,p、q作为指针等。
另外,要注意的是:全局变量在程序中不要定义太多,能用局部变量的就用局部变量。
如果要使用相关的变量,建议采用类的方式或者结构的方式存放,以减少具体变量的个数。
常量的命名常量所有的字母均为大写。
并且单词之间使用下划线”_”隔开。
编码规范(华为)
软件编程规范总则
1 排版
¹1-4:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低 优先级操作符处划分新行,操作符放在新行之首。 示例: if ((taskno < max_act_task_number) && (n7stat_stat_item_valid (stat_item))) { ... // program code }
act_task_table[taskno].duration_true_or_false = SYS_get_sccp_statistic_state( stat_item );
report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER)
仅供内部使用
2
Simpo PDF Merge and Split Unregistered Version -
录
6 11 18 20 22 28 36 40 44 50 52 53
Simpo PDF Merge and Split Unregistered Version -
软件编程规范总则
1 排版
1 排版
¹1-1:程序块要采用缩进风格编写,缩进的空格数为4个。 说明:对于由开发工具自动生成的代码可以有不一致。 ¹1-2:相对独立的程序块之间、变量说明之后必须加空行。 示例:如下例子不符合规范。 if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni;
if (...) { ... // program code }
【编号规则】文件编码规范(表一)
MYSDG-SF-10001-P
SF: specification Flue
MYSDG-08nnn-XX-RFQ-nn RFQ:Request for Quotation XX代表不同合同的类型
AB代表不同的供应商 MYSDG-08nnn-XX-AB-nn XX代表不同合同的类型
XX--S/S(Service/Soil) XX--D(Design) XX--S/Q(Service/Quality) XX--C(Construction) XX--E(Equipment) XX--M(Material)
59
施工招、投标文件
设备、工器具、家具采购招投标
60
文件
61
材料采购招、投标文件
供应商资料文件 62 采购文件 供应商资料
63
材料产品质量报告文件
64
工程勘察、设计合同、协议书等
65
监理合同
设计合同
施工承、发包及委托合同、协议
66
建设项目合 书等
67
同文件
设备、工具、器具采购合同
68
材料采购合同
其它(如租赁、咨询、供电、供
83
勘察文件质量检查报告
84
工程交、竣 设计文件质量检查报告
85
工验收文件 建筑工程室内环境质量检测报告
86
建筑工程土壤氡浓度检测报告
87
房屋建筑工程竣工验收报告
88
质量监督报告
89
消防工程验收意见书
90
电梯(扶梯)验收结果通知单
91
燃气工程竣工验收报告
92
环保验收文件
MYSDG-yymmdd-SR-nnn SR: Soil Rorport
编码规范
编码规范1. 目的 (2)2. 使用范围 (2)3. 基本要求 (2)4. 可读性要求 (2)5. 结构化要求 (3)6. 正确性与容错性要求 (3)7. 可重用性要求 (3)8. 命名规范 (4)8.1. 匈牙利命名法 (4)8.2. 基本规则 (4)8.3. 前缀表 (4)8.4. 使用样例 (5)9. 编码规格 (6)9.1. 基本规则 (6)9.2. 新增加文件的注释 (6)9.3. 新增加函数的注释 (7)9.4. 增加代码的注释 (7)9.5. 删除代码的注释 (8)9.6. 修改代码的注释 (8)9.7. 新增加的数据结构及全局常量和全局变量的注释 (8)10. 缩进的规则 (9)10.1. 控制结构的缩进 (9)10.2. 缩进的限制 (9)11. 其它注意事项 (9)1.目的良好的编程风格是提高程序可靠性非常重要的手段,也是多人合作开发项目的技术基础。
在软件编程过程中,如果每个程序员都按自己的习惯和风格编写程序,这种因人而异的程序风格势必降低程序的可读性,对软件的测试、交流、重用以及软件的维护产生极为不利的影响。
为了解决这个问题,最终提高开发效率,必须执行编码规范。
本规范在遵照ISO9001中源代码编写规范的基础上,将其中部分内容具体化。
目的在于通过该规范来避免不好的编程风格,增强程序的易读性,便于源代码的维护和管理。
2.使用范围本规范针对应用C/C++语言进行编程而制定,适用于本公司研发部相关项目C/C++程序的软件源代码的编写。
因此,在进行开发的编码阶段中,程序编码人员应严格遵循本规范。
3.基本要求●程序结构清析,简单易懂;●打算干什么,要简单、直接了当,代码精简,避免垃圾程序;●尽量使用标准库函数和公共函数;●不要随意定义全局变量,尽量使用局部变量;●使用括号以避免二义性;4.可读性要求●普通代码,可读性第一、效率第二;●保持注释与代码完全一致;●每个源程序文件,都有文件头说明;●每个函数,都有函数头说明;●主要变量(结构、联合、类或对象)定义或引用时,注释能反映其含义;●常量定义(DEFINE)有相应说明;●利用缩进来显示程序的逻辑结构,缩进量一致并以Tab键为单位;●循环、分支层次不要超过五层;●注释可以与语句在同一行,也可以在上行;●空行和空白字符也是一种特殊注释;●一目了然的语句不加注释;●注释的作用范围可以为:定义、引用、条件分支以及一段代码;●处理过程的每个阶段都有相关注释说明;●在典型算法前都有注释;●注释总是加在程序的需要一个概括性说明或不易理解或易理解错的地方。
01编码规范
01编码规范C#编码规范 ........................................................................... ...................................................... - 2 -1 文件组织............................................................................ .............................................. -2 -1.1 C#源文件 ........................................................................... .................................... - 2 - 1.2 目录安排 ........................................................................... .................................... - 2 - 2 缩进............................................................................ ...................................................... - 2 -2.1 分行 ........................................................................... ............................................ - 2 - 3 注释............................................................................ ...................................................... - 2 -3.1 块注释 ........................................................................... ........................................ - 2 - 3.2 单行注释 ........................................................................... .................................... - 3 - 3.3文档注释 ........................................................................... ..................................... - 3 - 4 声明............................................................................ ...................................................... - 3 -4.1每行声明的数量 ........................................................................... ......................... - 3 - 4.2 初始化 ........................................................................... ........................................ - 3 - 4.3 类和接口的声明 ........................................................................... ........................ - 3 - 5 语句............................................................................ ...................................................... - 4 -5.1 简单语句 ........................................................................... .................................... - 4 - 5.2 返回语句 ........................................................................... .................................... - 4 - 5.3 If, if - else, if else - if else语句 ........................................................................... .. - 4 - 5.4 for / foreach语句 ........................................................................... ....................... - 5 - 5.5 while / do �C while语句 ........................................................................... .............. - 6 - 5.6 switch语句 ........................................................................... .............................. - 6 - 5.7 try �C catch语句 ........................................................................... ......................... - 6 - 5.8 属性 ........................................................................... ............................................ - 7 - 5.9 枚举 ........................................................................... ............................................ - 8 - 6 空白............................................................................ ...................................................... - 8 -6.1 空行 ........................................................................... ............................................ - 8 - 6.2 内部空格 ........................................................................... .................................... - 8 - 7命名约定............................................................................ ............................................... - 8 -7.1 命名规范 ........................................................................... ................. - 9 - 7.2 WebControl 命名规范 ........................................................................... ............. - 9 - 7.3变量 ...................................................................................................................... - 10 - 7.4其他 ........................................................................... ........................................... - 10 - 8 编程实践............................................................................ ............................................ - 11 -8.1 书写顺序 ........................................................................... .................................. - 11 - 8.2 成员可视性 ........................................................................... .............................. - 11 - 8.3功能单一 ........................................................................... ................................... - 12 - 8.4使用枚举 ........................................................................... ................................... - 12 - 8.5 捕获异常 ........................................................................... .................................. - 13 - 9.其他注意事项............................................................................ .................................. - 13 -C#编码规范1 文件组织1.1 C#源文件把每个类都放在单独的文件中,文件名字和类名一致(用.CS作为扩展名)。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
盛世开天地产有限公司项目开发命名规则(第二小组)一编码规范目的为了统一软件开发设计过程的编程规范,使网站开发人员能很方便的理解每个目录,变量,控件,类,方法的意义;保证编写出的程序都符合相同的规范,保证一致性、统一性而建立的程序编码规范。
编码规范和约定必须能明显改善代码可读性,并有助于代码管理、分类范围适用于企业所有基于.NET平台的软件开发工作。
二编码规范概述:2.1 概述a 注释要求用汉语表示。
b 注释中,标明对象的完整的名称及其用途,但应避免对代码过于详细的描述。
c 每行注释的长度控制在50个字之内。
d 将注释与注释分隔符用一个空格分开。
e 不允许给注释加外框。
f 编码的同时书写注释,不要在编码完以后再补注释。
g 重要变量必须有注释,说明类型和用途。
h 变量注释和变量在同一行,所有注释必须对齐,与变量分开至少四个“空格”键。
i 典型算法必须有注释,可以简短一些。
j 在循环和逻辑分支地方的上行必须就近书写注释。
k 程序段或语句的注释在程序段或语句的上一行l 在代码交付之前,必须删掉临时的或无关的注释。
m 每行的代码应在100个字符以内,以便于阅读。
2.2 自建代码文件注释a) 数据库存储过程注释多行注释:/***************************************************************************** *创建时间:*作者:*功能:******************************************************************************/ 单行注释://2.3模块(类)注释模块开始必须以以下形式书写模块注释:///<summary>///Module ID:<模块编号,可以引用系统设计中的模块编号>///Depiction:<对此类的描述,可以引用系统设计中的描述>///Author:作者中文名///Create Date:<模块创建日期,格式:YYYY-MM-DD> ///</summary>2.4 在类的方法声明前必须以以下格式编写注释/// <summary>/// depiction:<对该方法的说明>/// </summary>/// <param name="<参数名称>"><参数说明></param>/// <returns>///<对方法返回值的说明,该说明必须明确说明返回的值代表什么含义> /// </returns>///Writer:作者中文名///Create Date:<方法创建日期,格式:YYYY-MM-DD>2.5代码间注释代码间注释分为单行注释和多行注释://<单行注释>/*多行注释1多行注释2多行注释3*/三命名总体规则名字应该能够标识事物的特性。
名字一律使用英文单词,而不能为拼音。
名字尽量不使用缩写,除非它是众所周知的。
名字可以有两个或三个单词组成,但不应多于三个,控制在3至30个字母以内。
名字中,多个单词用大写第一个字母(其它字母小写)来分隔。
例如:IsSuperUser。
名字尽量使用前缀而不是后缀。
名字中的单词尽量使用名词,如有动词,也尽量放在后面。
例如:FunctionUserDelete(而不是FunctionDeleteUser)。
不要使用匈牙利命名法。
四数据库命名规范1、表命名:用一个或三个以下英文单词组成,单词首字母大写,如:DepartmentUsers;2、表主键名称为:表名+ID,如Document表的主键名为:DocumentID3、存储过程命名:表名+方法,如:p_my_NewsAdd,p_my_NewsUpdate;五服务器控件命名规范数据库服务器命名规范,控件名缩写+控件作用单词的全称,如:btnNext, txtPassword(密码文本框),txtRPassword(密码确认文本框),单词的第一个字母必须大写如果有多个单词,则为控件缩写+控件作用的第一个单词+第二个单词的全称,每个单词名的第一个字母必须大写附件:服务器控件名缩写表a、web控件web控件名缩写AdRotator artButton btnCalendar cdCheckBox chkCheckBoxList chklCompareValidator cpvCustomValidator ctvDataGrid dgDataList dlDropDownList ddlHyperLink hlImage imgImageButton IbtnLabel labLinkButton lbtnListBox lstPanel plPlaceHolder phRadioButton rbRadioButtonList rblRangeValidator rvRegularExpressionValidator revRepeater rpRequiredFieldValidator rfvTable tbTableCell tcTableRow trTextBox txtValidationSummary vsXML XMLb、html控件html控件名缩写HtmlAnchor hahHtmlButton hbtnHtmlForm hformHtmlGenericControl hgcHtmlImage himgHtmlInputButton(按钮)htxtHtmlInputButton(重置)hrbtnHtmlInputButton(提交)hcbtnHtmlInputCheckBox hickHtmlInputFile hifileHtmlInputHidden hihiddenHtmlInputImage hiimgHtmlInputRadioButton hirbHtmlInputText(密码)hpwdHtmlInputText(文本)hitxtHtmlSelect hsltHtmlTable htabHtmlTableCell htcHtmlTableRow htrHtmlTextArea htxta六代码规范6-1:相对独立的程序块之间、变量说明之后必须加空行。
示例:如下例子不符合规范。
if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;应如下书写if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;6-2:较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。
示例:perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_table[frame_id * STA T_TASK_CHECK_NUMBER + index].occupied= stat_poi[index].occupied;act_task_table[taskno].duration_true_or_false= SYS_get_sccp_statistic_state( stat_item );report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER)&& (n7stat_stat_item_valid (stat_item))&& (act_task_table[taskno].result_data != 0));6-3:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首。
示例:if ((taskno < max_act_task_number)&& (n7stat_stat_item_valid (stat_item))){... // program code}for (i = 0, j = 0; (i < BufferKeyword[word_index].word_length)&& (j < NewKeyword.word_length); i++, j++) {... // program code}for (i = 0, j = 0;(i < first_word_length) && (j < second_word_length);i++, j++){... // program code}6-4:若函数或过程中的参数较长,则要进行适当的划分。
示例:n7stat_str_compare((BYTE *) & stat_object,(BYTE *) & (act_task_table[taskno].stat_object),sizeof (_STA T_OBJECT));n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER+ index, stat_object );6-5:不允许把多个短语句写在一行中,即一行只写一条语句。
示例:如下例子不符合规范。
rect.length = 0; rect.width = 0;应如下书写rect.length = 0;rect.width = 0;6-6:if、for、do、while、case、switch、default等语句自占一行,且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。
示例:如下例子不符合规范。
if (pUserCR == NULL) return;应如下书写:if (pUserCR == NULL){return;}6-7:对齐只使用空格键,不使用TAB键。
说明:以免用不同的编辑器阅读程序时,因TAB键所设置的空格数目不同而造成程序布局不整齐,不要使用BC作为编辑器合版本,因为BC会自动将8个空格变为一个TAB键,因此使用BC合入的版本大多会将缩进变乱。