原文

TSL脚本编写规范

 51Testing软件测试网uX_@ W;g9R-s

导言

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

      为了使自己和他人能够比较容易的阅读和理解源程序，本文对今后TSL的编写制订了一个规范。

 51Testing软件测试网|"~%C+sIWR"q

一、排版

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

说明：缩进的空格数为4个，不能使用Tab键。不同的编辑环境导致不同的结果。51Testing软件测试网1}g3~_ZyX1p;P

错误的示范：51Testing软件测试网3pffz.}#Q*D7Z:u

for(counter = count -24; counter < count -1; counter++)
6ac
eV Y+aw9xE0{51Testing软件测试网PUHEm3\
list_get_item("ListBox",counter,item);51Testing软件测试网nCv8_Stvj
str = str & item &"\r\n";
p uEz
YH4bO1?0}

 51Testing软件测试网9N_$?hjnP?x

正确的示范一：51Testing软件测试网_ i3ttxc;h3^ ]

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

{
Y8r%~d lbu4R0   list_get_item("ListBox",counter,item);51Testing软件测试网)F+R&~X+O cl-au
   str = str & item &"\r\n";51Testing软件测试网(N8@3]`H0p lJ7a
}51Testing软件测试网mI#@{.F C:l|

 51Testing软件测试网5GF5VB5v*f[

正确的示范二：51Testing软件测试网-Lt%hA6] b
p&R1U

for(counter = count -24; counter < count -1; counter++){
t,s9z)JH*x}0   list_get_item("ListBox",counter,item);51Testing软件测试网mP_(H |^6j oW2v+V
   str = str & item &"\r\n";

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

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

错误的示范：

  row1=0;
ks3G:F T4ny6J0  row2=0; 51Testing软件测试网#U~9T0@iM8d0a0C
  ##open two tables51Testing软件测试网e^)p,D
?b6\UL
  rc =ddt_open(tableFirst, DDT_MODE_READ);51Testing软件测试网0Y6Z[@\;]
  if(rc!= E_OK && rc != E_FILE_OPEN)
+NY-TLT kh,\0      pause("Cannot open table");
;Q'zs:r'c.Gp0  ddt_get_row_count(tableFirst,RowCount1);

正确的示范：51Testing软件测试网3kE$XGAD2wqm

row1=0;
/E`-C-X+v ]0  row2=0; 51Testing软件测试网,tg6J,jEq.a.Q

51Testing软件测试网M WuP/V2t
  ##open two tables51Testing软件测试网?-\ w%C"m0Y'i
  rc =ddt_open(tableFirst, DDT_MODE_READ);51Testing软件测试网t-yPv `a^t
  if(rc!= E_OK && rc != E_FILE_OPEN)51Testing软件测试网zf~3bv8EN
      pause("Cannot open table");

51Testing软件测试网nXDRb6p
  ddt_get_row_count(tableFirst,RowCount1);51Testing软件测试网\8f-Q~!x;w

 51Testing软件测试网K?q~f2[Y6m O'S6t

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

说明：对大于80个字符的语句，要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读51Testing软件测试网0T(YUS?!|C!U

 51Testing软件测试网vuc)eh0qAKR

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

说明：循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。51Testing软件测试网o+{? }
]|5E@

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

说明：便于清晰的阅读函数

 51Testing软件测试网7k w f)RYo[_@.J

错误的示范：

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

 51Testing软件测试网.NvLAIA)VG

正确的示范：

tl_step("2:对比两张表",FAIL,51Testing软件测试网fK^2?,DET N9H

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

 51Testing软件测试网)lYXz&X{R

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

说明：即一行只写一条语句51Testing软件测试网G9C)ECG.v:N&\

错误的示范：

autoa;autob;

 51Testing软件测试网"[&u*oiG R3Q

正确的示范：

autoa;
0rJ5_6sg,B'^8{0autob;51Testing软件测试网/D|(BPA

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

说明：if、for、do、while、case、switch、default等语句自占一行，且if、for、do、while等语句的执行语句部分无论多少都要加括号{}51Testing软件测试网VE!}$l\|!M z!|y/P}

错误的示范：

if(rc!= E_OK && rc != E_FILE_OPEN)pause("Cannot open table");51Testing软件测试网j{.BE*_.Z+M

 51Testing软件测试网M)d5qY0uC]z/{"yV`

正确的示范：

if(rc!= E_OK && rc != E_FILE_OPEN){
Wnm8`
HOY0   pause("Cannot open table");
Yo+g5}{0}

 51Testing软件测试网7Qy1z8B/LyNZ

1.8操作符前后需要加空格

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

 51Testing软件测试网 ?@ L7J nff-xAA

正确的示范一：逗号、分号在后面加空格51Testing软件测试网^|*L |3Xr u

statica, b, c;

正确的示范二：比较操作符、赋值操作符、逻辑操作符等双目操作符的前后加空格

if(current_time >= MAX_TIME_VALUE && current_date<=DATE){51Testing软件测试网C}CIC$mb6x
   
_o0i,C\/USS;{0   a = b + c;51Testing软件测试网 NY2[RlR.{ ?
   51Testing软件测试网#AfpO6NG.m
}

 51Testing软件测试网J&b.AQfoG6O

正确的示范三：单目操作符的前后不加空格

if(current_time!=MAX_TIME_VALUE){
bEE/@C uo9TUp0   
*x \[.w'jx@7M;{0   a++;51Testing软件测试网-F#@au!Y8x6s0H
   
io:w$~!k1G0}51Testing软件测试网URX9gr:d;xf

 51Testing软件测试网k4vg#d:r{

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

说明：使关键字更加突出、明显。51Testing软件测试网/Z@It&s#i3t.V!E

 51Testing软件测试网/H u@{3YHX

错误的示范：51Testing软件测试网-K.S2j`+fCoFn

if(a >0){
bHc3@!xA5_0
xdy?"C~i2cc8C0   b=1; 
WZ^y7l!I9}'eS0 51Testing软件测试网Rtjud2L
}51Testing软件测试网5wf+M^ N I{-^T

正确的示范：

if(a >0){
oA Be ZL051Testing软件测试网D6W/h:KV$o5H8~v
   b=1; 51Testing软件测试网 s7H0Ol!?cf9H
 
8~:SI1o8B+]*U5G7n4V0^7U0}

51Testing软件测试网kX7c"fp}C

二、注释

 51Testing软件测试网E$fY,JRB

2.1有效注释量必须适中

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

2.2脚本程序的头部注释

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

正确的示范：

###########################################################

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