文档介绍：转载 MATLAB 编程风格指南转载
原文地址:MATLAB编程风格指南(转载)作者:云辉之家MATLAB编程风格指南
--Richard Johnson Version ,
"Language is like acracked kettle on which we beat tuned to dance to,while all the time we long to move the stars to pity."
-Gustave Flaubert,in Madame Bovary
目录:
一、简介
二、命名规则
1、变量
2、常数
3、结构体
4、函数
5、概要(General)
三、文件与结构
1、M文件
2、输入输出
四、语句(Statements)
1、变量
2、循环语句
3、条件语句
4、小结
五、布局、注释与文档
1、布局
2、空白空间(White Space)
3、注释
4、文档
六、参考文献
一、简介
有关MATLAB代码的建议通常强调的是效率,譬如说有关"不要用循环"等的建议,本指南与之不同。本指南主要考虑的是代码(格式)的正确性、清晰性与通用性。本指南的目的在于帮助写出更可能正确、易于理解、更具有共享性与更利于维护的代码。正如Brian Kernighan写道:"Well-written programs are better than badly-written ones-they have fewer errors and are easier to debug and to modify―― so it is important to think about style from the beginning."(良好的写作规范的程序比糟糕的写作规范的要好,因为他们具有较少的错误、易于调试与修改,因此,从一开始就考虑风格是很重要的)。
本指南列举的MATLAB代码编写的建议在软件开发小组实际工作中得到一致性的认可。本指南与C、C++与Java的同类手册在整体上是相似的,但是针对MATLAB的特征与历史进行了修正。指南中的建议是基于多种其他代码语言的指南与个人经验而来的。指南主要是针对MATLAB而写的,但是它对于相近的语言,如Octave、Scilab和O-Matrix等的编程也有所帮助。
指南不是戒律,其目的在于简洁易懂地帮助程序员写出好的代码。许多组织有理由偏离这个目的。
"You got to know the rules before you can break' it's no fun."
―― Sonny Crockett in Miami Vice MATLAB是MathWorks公司的注册商标,在本指南中,缩写TMW指The Mathworks公司。
本著作献给那些致力于仔细提高进步的人们。
二、命名规则
Pathrick Raume:"A rose by any other name confues the issue。"(?玫瑰如果以其他名字则会导致事情的混乱)
一个开发团体建立一个命名规则可能会成为一个可笑的争议性问题。本节描述了一个常用的规则。它对于单个的程序员理解命名规则特别有用。
1、变量
变量的名字应该能够反应他们的意义或者用途。
(1)变量名应该以小写字母开头的大小写混合形式,譬如:linearity,credibleThreat,qualityofLife等。这在C++开发团体中是普遍实用的。TMW有时候以大写字母开头命名一个变量名,但是这种用法在其他的语言中通常作为类型或者结果的保留用法。
(2)分割复合变量名的各个部分中间通常有两种做法,前面例子的这种(以大写字母分割)是其中的一种,虽然可读性比较好,但是在其他语言变量名中并不很常用。另外一种考虑的方法是在变量名中采用下划线,但是下划线在MATLAB的Tex解释程序中会将其翻译为下标转换符。
(3)应用范围比较大的变量应该具有有意义的变量名,小范围应用的变量应该用短的变量名。
实际上,大多数变量都应该具有有意义的变量名,短变量名通常作为结构申明时候必须阐明意义的情况下的变量的保留用法。当然,作为"草稿变量"的的临时存储空间或者索引可以用短名字。程序员在读到这样的变量的时候,可以假定这个变量的值在没有几行之后的代码中就不会再用到。通常的"草稿变量"整数的时候用i,j,k,m,n(不过我认为最好少用i,j,因为他们作为MATLAB中的永久性常量表示虚数单位的。译者注),双精度数的时候常用x,y和z。
(4)前缀n应该用在作为数值对象的申明的时候,这一符号来自于数学,在数学中这被作为标明