搜索
11.标识符命名原则标识符的名字应当直观，其长度应当符合“最小长度，最大信息量”原则。1)非矩阵变量：变量名应该以小写字母开头的大小写混合形式譬如：shadowFadingTable，servingSector，rxBufferForReuserID，userPriorityProfile，mcsOneRetrieval等循环变量应该以i、j、k等为前缀，如fori_File=1：nFilesforj_Position=1：nPositions避免仅用最后的字母s(表示单复数)区别两个变量,例如point和points.可以用类似pointArray的形式加以区别。避免使用一个关键字或者特殊意义的字作为变量名结构体的命名应该以一个大写字母开头，结构体的命名应该是暗示性的，并且不需要包括字段名（fieldname）应采用Segment.length，避免用Segment.SegmentLength2)常数：命名常数（包括全局变量）应该采用大写字母，用下划线分割单词，如MAX_ITERATIONS，COLOR_RED参数可以以某些通用类型名作为前缀，如COLOR_RED，COLOR_GREEN3）草稿变量，含矩阵，结构体，元胞：应用范围比较大的变量应该具有有意义的变量名，作为“草稿变量”的的临时存储空间或者索引可以用短名字。程序员在读到这样的变量的时候，可以假定这个变量的值在没有几行之后的代码中就不会再用到。通常的“草稿变量”整数的时候用i，j，k，m，n（最好少用i，j，因为他们作为MATLAB中的永久性常量表示虚数单位的）。双精度数的时候常用x，y和z。m表示矩阵，没有m表示标量命名上将cell,struct与MATLAB中最常见的numericarray,即数值矩阵区分开来.n用于整数变量,如n_File.m用于一般的矩阵，如matrix_channelHFResponse;c用于cellarray,如cell_temp=cell(1,4);s用于structarray,如stuct_user=struct('field',{});matrix，cell，stuct后面的channelHFResponse，user用来表示有特定含义的中间变量，比如matrix_channelHFResponse，用来表示计算channelHFResponse时中间变量。4）函数：函数名应该采用小写字母，函数名应该是具有意义的，下划线分割单词如采用：compute_total_width（）避免compwid（）前缀get/set应该作为访问对象或者属性的保留前缀，如getobj（.）。前缀compute应该用在计算某些量的函数的地方computespread（）。前缀is应该用在布尔函数的命名的地方，如iscomplete（）。Find，initialize类似。22.编码及文档注释要求及实例2.1代码版式2.1.1M文件函数说明function[函数输出参数]=函数名(函数输入)%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%此处为函数名，如果不是函数文件就取消此行%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%创建人：%日期：%修改人：%日期：%函数变量及功能的简单描述%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%--函数主体2.1.2编码设计本部分说明了M文件编码的设计，包括以下几个方面：垂直间隔，水平间隔，缩进与对齐，注释。2.1.2.1垂直间隔1、空行空行起着分割块或段落的作用，块（段落）之间一般留一个或两个空行。空行使用规则：逻辑块之间要留空行；结构体定义之间要留空行；函数定义体之间要留空行；函数体内，完整的控制结构和单独的语句块之间要留空行；逻辑上密切相关的语句序列之间不要留空行；2、换行注意事项不在一行使用多个语句。唯一的例外是for语句。For语句的初始化，条件和循环都可以在一行中。例如for(bcnl_num=0;bcnl_numcount;bcnl_num++)或者还有switch语句，如果动作很短并且相同的话（后面有详细描述）。3If语句并不是例外：执行语句总是另起一行。例如：if(bcnl_numcount)bcnl_num=count;｛｝与case总是独占一行。2.1.2.2水平间隔逗号后面要有空格，但是不要在结构的成员与指针操作符前后有空格。例如：foo.index在=，&&，+，-，,与||前后加上空格，包括：如simpleAverage=(firstTerm+secondTerm)/two;1:nIterations另起一行时，后面一行和前面一行中要继续的地方对齐：weithedPopulation=(doctorWeight*nDoctors)+…(layerWeight*nLawyers)+…(chiefWeight*nChiefs)；...function(param1，param2，…param3)2.1.2.3长行拆分一行代码不能超过180个字符。长行拆分时，在逻辑断点处分行。拆分时，运算符放在被拆分行的尾部，而不是新行的首部。拆分后的新行应与被拆分行采用能够表现出逻辑关系的对齐方式。示例：if(((new_shape.xleft_border)&&(new_shape.xright_border))&&((new_shape.ybottom_border)&&(new_shape.ytop_border))){draw(new_shape);}2.1.2.4代码行及行内空格（1）代码行中不运行出现中文。（2）关键字后要留空格。像const、inline、case等关键字后要留空格，以辨析关键字；像if、for、do、while、switch等关键字后要留空格再跟左括号“（”，以突出关键字。（3）“（”若不在一行的开始，应与前面的字符空格。例如，if、while、do-while、switch、for语句等控制结构块的“（”应与这些关键字语句之间空格。（4）“，”之后要留空格；若“；”不是一行的结束符，后面也要留空格。（5）“？”、“：”前后都要留空格。（6）“（”、“[”向后紧跟，“]”、“，”、“；”、“）”向前紧跟，紧跟处不留空格。（7）一元运算符与所作用的操作数之间不要加空格，如“！”、“～”、“++”、“&”、“*”等。（8）“.”、“-”这类运算符前后都不要留空格。42.1.2.5缩进与对齐缩进的水平是一个TAB键，可将编辑器的TAB符定义为4个空格。嵌套块之间使用4个空格（一个TAB键）的缩进方式。模块和子程序头以及子程序声明从第一列起。下列情况下缩进一个水平：子程序声明条件（看下面）循环的结构switch语句caselabels条件的else与if有相同的缩进。因此格式就是：fid=fopen（fileName）；if（fid~=-1）statementselsestatementsendswitch语句的一般格式：switch（condition）caseABC处理语句；caseDEF处理语句；otherwise处理语句；end注释与它们作注释的代码部分有相同的缩进（见Comments）。2.1.2.6注释1)程序内部不同功能模块要空一行，同时附注释说明模块的作用、功能。这样程序结构清晰易懂，便于同学间学习交流。例如：%%注释说明下模块一的功能…模块一…代码…此处为空行5%%注释说明下模块二的功能…模块二…代码…2)多层循环嵌套要在每一个结束的end后加注释说明该层循环结束例:for%循环1for%循环2for%循环3……代码段……end%循环3结束end%循环2结束end%循环1结束3)用于理解一小段代码含义的注释，统一写在代码上方，如4）用于理解一句代码的意思可以写在代码后方，但是注意不能超过180字符。太长可以考虑写在代码上方。5）大段代码，有完整的阶段性的运行结果，需要使用%%形式，使用单元来注释。63.软件编写说明写作规范作为软件工程过程的一个阶段，程序编码是设计的继续。然而，在编码中所遇到的问题，如程序设计语言的特性和程序设计风格会深刻地影响软件的质量和可维护性。3.1对源程序的质量要求为了保证程序编码的质量，程序员必须深刻理解、熟练地掌握并正确运用程序设计语言的特性。然后，软件工程项目对代码编写的要求绝不仅仅是源程序语法上的正确性，也不只是源程序中没有各种错误，此外，还要求源程序具有良好的结构性和良好的程序设计风格。例如写出的源程序便于阅读，又便于测试和排除所发现的程序故障，就能够有效地在开发期间消除绝大多数在程序中隐藏的故障，使得程序可以做到正常稳定地运行，极大地减小了运行期间软件失效的可能性，大大提高了软件的可靠性。3.2结构化程序设计程序编码这一阶段的工作是把软件的详细设计变换成用某一种程序设计语言编写的可实现的源程序，结构化程序设计就是在编写程序时首先必须考虑的问题。3.2.1结构化程序设计的原则1)使用语言中的顺序、选择、重复等有限的基本控制结构表示程序逻辑。2)选用的控制结构只准许有一个入口和一个出口。3)程序语句组成容易识别的块，每块只有一个入口和一个出口。4)复杂结构应该用基本控制结构进行组合嵌套来实现。5)语言中没有的控制结构，可用一段等价的程序段模拟，但要求该程序在整个系统中应前后一致。3.3程序设计风格随着软件规模的增大，复杂性增加，人们逐渐看到，在软件生存期中需要经常阅读程序。特别是在软件测试段和维护段，编写程序的人与参与测试、维护的人都要阅读程序。人们认识到，阅读程序是软件开发和维护过程中的重要组成部分，而且读程序的时间比写程序的时间还要多。因此，程序实际上也是一种供人阅读的文章，所以就有风格问题。程序设计风格包括四个方面：源程序的文档化，数据说明的方法，语句结构和输入/输出方法中值得注意的问题。3.3.1程序的文档化源程序的文档化包括选择标识符（变量和标号）的名字、安排注释以及程序的视觉组织7等。1)符号的命名符号即标识符，包括模块名、变量名、子程序名以及数据区名、缓冲区名等。这些名字应能反应它所代表的实际东西，应有一定的实际意义，使其能够见名知意，有助于对程序功能的理解。2)程序的注释夹在程序中的注释是程序员与日后的程序读者之间通信的重要手段。正确注释能够帮助读者理解程序，可为后续阶段进行测试和维护，提供明确的指导。大多数程序设计语言允许用自然语言来注释，这就给阅读程序带来了很大的方便。一些正规的程序文本中，注释行数量占到整个源程序的1/3到1/2，甚至更多。注释分为序言性注释和功能性注释。序言性注释通常置于每个程序模块的开头部分，它应当给出程序的整体说明，对于理解程序具有引导作用。有关项目包括：程序标题；有关该模块功能和目的的说明；主要算法；接口说明：包括调用形式，参数描述，子程序清单；有关数据描述（重要的变量及其用途，约束或限制条件，以及其他有关信息）；模块的位置（在那一个源文件中，或隶属于哪一个软件包）；开发简历：模块设计者，复审者，复审日期，修改日期及有关的说明等。（参照软件工程中相应的例子）功能性注释嵌在源程序体中，用以描述其后的语句或程序段是在做什么工作，也就是解释下面要“做什么”，或是执行了下面的语句会怎么样。而不需要解释下面怎么做，因为解释怎么做常常是与程序重复的，并且对阅读者理解程序没有什么帮助。书写功能性注释，要注意以下几点：用于描述一段程序，而不是每一个语句；用缩进和空行，使程序与注释容易区别；注释要正确。3)视觉组织――空格、空行和缩进一个程序如果写得密密麻麻，分不出层次来常常是很难看懂的。优秀的程序员在利用空格、空行和缩进的技巧上显示了他们的经验。恰当的利用空格，可以突出运算的优先性，避免发生运算的错误。3.3.2数据说明虽然在设计阶段已经确定了