原文

TSL脚本编写规范

导言

我们在Mercury Interactive Systems（WinRunner）中创建的脚本是由TSL（Test scrīpt Language）写成的。TSL是一种强化了的类C的编程语言。它是专门设计来用于测试的。在Meercury Interactive的集成测试环境的核心中，TSL是比较高层次的，而且也比较容易使用的。它既有传统编程语言的灵活与强大，也结合了许多Mercury Interactive专门开发来用于测试的功能。

      为了使自己和他人能够比较容易的阅读和理解源程序，本文对今后TSL的编写制订了一个规范。51Testing软件测试网s%c!E*i.|Rg6K)M4F

 51Testing软件测试网/?5\a:Lx'o&z

一、排版

1.1程序块采用缩进风格编写

说明：缩进的空格数为4个，不能使用Tab键。不同的编辑环境导致不同的结果。

错误的示范：51Testing软件测试网f){2}erc

for(counter = count -24; counter < count -1; counter++)
-K9I:B2`-D5H$dg0{
;X4OGR H4W\\2o0list_get_item("ListBox",counter,item);51Testing软件测试网 ?#B4[s&g;Z
str = str & item &"\r\n";51Testing软件测试网;WwTi/F!zR)?
}51Testing软件测试网$FBdu7H8B(G.lp

正确的示范一：51Testing软件测试网4Ql}_g.jM

for(counter = count -24; counter < count -1; counter++)

{51Testing软件测试网/pF6US*nN?i
   list_get_item("ListBox",counter,item);
jaf#{UC&i5t F0   str = str & item &"\r\n";
K-v5d
dUCR1s0}51Testing软件测试网F!M qSl2l9_8\AM

 51Testing软件测试网O?;a\ b2I

正确的示范二：

for(counter = count -24; counter < count -1; counter++){51Testing软件测试网 m"Hzg+S
   list_get_item("ListBox",counter,item);
#I6o,ac @v{7P.j0   str = str & item &"\r\n";

51Testing软件测试网'[V
y7a] a

 51Testing软件测试网CQ}Oe5J z

1.2相对独立的程序块之间、变量说明之后必须加空行

说明：便于清晰的显示程序的结构。

错误的示范：

  row1=0;
|!Y_p9g Q0  row2=0; 
%VWpv&}%l0  ##open two tables
fL5U`CjX3XgKQ%H0  rc =ddt_open(tableFirst, DDT_MODE_READ);
+xr H9y~.~0  if(rc!= E_OK && rc != E_FILE_OPEN)
a!LxU3h"B0      pause("Cannot open table");
O-q"?fq7\?G0  ddt_get_row_count(tableFirst,RowCount1);51Testing软件测试网X B&m^Op

正确的示范：51Testing软件测试网lY2sD,juQ

row1=0;51Testing软件测试网Mt]"p"Jrq`
a
  row2=0; 51Testing软件测试网K$w9c kuD ^&U `

51Testing软件测试网#A!f'X&Vu-i#CI
  ##open two tables51Testing软件测试网JT?oC#[h:[;x
  rc =ddt_open(tableFirst, DDT_MODE_READ);
T%M'\.Q)Mox4I?H&|&y$c/H0  if(rc!= E_OK && rc != E_FILE_OPEN)51Testing软件测试网
m R3?|,Z%Y
      pause("Cannot open table");

'{)L+Z:EW,s0  ddt_get_row_count(tableFirst,RowCount1);51Testing软件测试网;f8]"_"S5Vjy

 51Testing软件测试网5S#x5dA%~

1.3较长的语句要分成多行书写

说明：对大于80个字符的语句，要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读

1.4循环、判断中有较长的语句需要划分成多行

说明：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。51Testing软件测试网-tW!jBAn7Qd` ZI

1.5若函数中的参数较长，则要进行适当的划分

说明：便于清晰的阅读函数51Testing软件测试网UW$c1o"tw-QQ

 51Testing软件测试网F/Ks]PT

错误的示范：

tl_step("2:对比两张表",FAIL,"表"&tableFirst&"的第"&col1&"列第"&table_Row1&"行的值为："&val1&");

正确的示范：51Testing软件测试网)Yx&Dov@+]

tl_step("2:对比两张表",FAIL,

"表"&tableFirst&"的第"&col1&"列第"&table_Row1&"行的值为："&val1&");

 51Testing软件测试网 |8G&N&MT,t

1.6不允许把多个短语句写在一行中

说明：即一行只写一条语句51Testing软件测试网?"}*qp]mcg

错误的示范：

autoa;autob;

 51Testing软件测试网u2}.@6b7gAyJ-G

正确的示范：51Testing软件测试网.d(_f\zf:A4T

autoa;
Njv5@*l$Z0autob;51Testing软件测试网Fs@*c L&O

1.7条件、循环语句需要对语句块进行控制

说明：if、for、do、while、case、switch、default等语句自占一行，且if、for、do、while等语句的执行语句部分无论多少都要加括号{}51Testing软件测试网CS'`p9D qyz3Z

 51Testing软件测试网,{.hq#c[4G!a"cJ"b

错误的示范：

if(rc!= E_OK && rc != E_FILE_OPEN)pause("Cannot open table");

 51Testing软件测试网G xA,HiQ

正确的示范：

if(rc!= E_OK && rc != E_FILE_OPEN){51Testing软件测试网oB0qpt"mIg
   pause("Cannot open table");
DK)y w#N
I0}

1.8操作符前后需要加空格

说明：在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或者前后要加空格。采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性是相对的，所以，在已经非常清晰的语句中没有必要再留空格，如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格，多重括号间不必加空格。在长语句中，如果需要加的空格非常多，那么应该保持整体清晰，而在局部不加空格。给操作符留空格时不要连续留两个以上空格。51Testing软件测试网wy'T;s c-G%LD#j

 51Testing软件测试网5d]4C(W7?9nEW`

正确的示范一：逗号、分号在后面加空格51Testing软件测试网2|E)K0k3iwS

statica, b, c;

正确的示范二：比较操作符、赋值操作符、逻辑操作符等双目操作符的前后加空格51Testing软件测试网gb.ai;A:H

if(current_time >= MAX_TIME_VALUE && current_date<=DATE){51Testing软件测试网)V`(}Gq0Vt%E ]
   
f*^#[G9B,DI/T0   a = b + c;
2H'b I9Q/G2~2L0   51Testing软件测试网uM6n xf@
}51Testing软件测试网La
X0Q4S1A(L1u2J/i

正确的示范三：单目操作符的前后不加空格51Testing软件测试网%\Q$@?y/~;LV

if(current_time!=MAX_TIME_VALUE){51Testing软件测试网5b]~S)P#N.B#igf
   51Testing软件测试网!T"Mh TJYc,C+P P
   a++;
2[;LAnw)l:\ c0   
mf2f0T.nM S*h5n\0}

1.9 if、for、while、switch等与后面的括号间应加空格

说明：使关键字更加突出、明显。51Testing软件测试网+OtYRi

 51Testing软件测试网9@
[fJ\;M0n#p!g

错误的示范：

if(a >0){51Testing软件测试网 fD!zT2hT S?.O(MM

Jw/xW1J#O0   b=1; 51Testing软件测试网xm[yOp(rb6|
 51Testing软件测试网t ]S*~bb
}51Testing软件测试网X _?FL2c

 51Testing软件测试网0S+?C n^,qP1S

正确的示范：51Testing软件测试网%^nwr5K?,d,V%x
sb

if(a >0){51Testing软件测试网&g@n t3A9N
51Testing软件测试网(rQj j u
   b=1; 
r$y3IK|5A"pR0 51Testing软件测试网#Xd9l1N8TO
}

51Testing软件测试网wJ}'b(?"zqiO

二、注释

2.1有效注释量必须适中

说明：一般情况下，源程序的有效注释量必须在20％以上。注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。51Testing软件测试网)g2XKY6t+w X

2.2脚本程序的头部注释

 51Testing软件测试网}2b){`b8o?n

说明：脚本程序头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等

正确的示范：

 51Testing软件测试网)w.ut$a9s^

###########################################################51Testing软件测试网5SE5sa)F]!d,q(|,?

# Copyright (C), 1988-1999, HSIT. Co., Ltd.