VBScript 程式撰写规格

VBScript 有一套完整的运算符,包括算术运算符、比较运算符、连接运算符和逻辑运算符。
运算符优先级
当表达式包含多个运算符时,将按预定顺序计算每一部分,这个顺序被称为运算符优先级。可以使用括号越过这种优先级顺序,强制首先计算表达式的某些部分。运算时,总是先执行括号中的运算符,然后再执行括号外的运算符。但是,在括号中仍遵循标准运算符优先级。
当表达式包含多种运算符时,首先计算算术运算符,然后计算比较运算符,最后计算逻辑运算符。所有比较运算符的优先级相同,即按照从左到右的顺序计算比较运算符。算术运算符和逻辑运算符的优先级如下所示:
[code]
<TABLE WIDTH=87% BORDER=1 CELLPADDING=5 CELLSPACING=0>
<TR BGCOLOR=#DDDDDD VALIGN=TOP ALIGN=CENTER>
<TD COLSPAN=2><FONT SIZE=2><B>算术运算符</B></FONT></TD>
<TD COLSPAN=2><FONT SIZE=2><B>比较运算符</B></FONT></TD>
<TD COLSPAN=2 ><FONT SIZE=2><B>逻辑运算符</B></TD></FONT></TR>

什麽是程式撰写规格?
程式撰写规格就是一些对您使用 Microsoft Visual Basic Scripting Edition 
开发程式时会有帮助的建议。
它包含了下列数项:物件、变数和程序的命名规格 

什么是 VBScript 数据类型?
VBScript 只有一种数据类型,称为 Variant。Variant 是一种特殊的数据类型,根据使用的方式,它可以包含不同类别的信息。因为 Variant 是 VBScript 中唯一的数据类型,所以它也是 VBScript 中所有函数的返回值的数据类型。
最简单的 Variant 可以包含数字或字符串信息。Variant 用于数字上下文中时作为数字处理,用于字符串上下文中时作为字符串处理。这就是说,如果使用看起来象是数字的数据,则 VBScript 会假定其为数字并以适用于数字的方式处理。与此类似,如果使用的数据只可能是字符串,则 VBScript 将按字符串处理。当然,也可以将数字包含在引号 (” “) 中使其成为字符串。 

<TR  BGCOLOR=#DDDDDD VALIGN=TOP>
<TD><FONT SIZE=2><B>描述</B></FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2><B>符号</B></FONT></TD>
  
<TD><FONT SIZE=2><B>描述</B></FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2><B>符号</B></FONT></TD>
<TD><FONT SIZE=2><B>描述</B></FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2><B>符号</B></FONT></TD></TR>

写注解时的规格 
文字格式和缩排的使用原则 
使用一致的程式撰写规格之主要理由在於可以标准化一个 script 或一组 script 的架构和
程式码样式。如此一来,您和其它人便可以轻松地了解这些程式码的意义。使用良好的程式
撰写规格,可提高原始程式码的精确度、可读性和清晰度,而且可使它与其他程式语言规格
更具一致性和直觉性。 

Variant 子类型
除简单数字或字符串以外,Variant 可以进一步区分数值信息的特定含义。例如使用数值信息表示日期或时间。此类数据在与其他日期或时间数据一起使用时,结果也总是表示为日期或时间。当然,从 Boolean 值到浮点数,数值信息是多种多样的。Variant 包含的数值信息类型称为子类型。大多数情况下,可将所需的数据放进 Variant 中,而 Variant 也会按照最适用于其包含的数据的方式进行操作。
下表显示 Variant 包含的数据子类型:
[code]
<TABLE WIDTH=87% BORDER=1 CELLPADDING=5 CELLSPACING=0>
<TR BGCOLOR=#DDDDDD VALIGN=TOP><TD WIDTH=15%><FONT SIZE=2><B>子类型</B></FONT></TD><TD WIDTH=85%><FONT SIZE=2><B>描述</B></FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>求幂</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>^</FONT></TD>
   <TD><FONT SIZE=2>等于</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>=</FONT></TD>
<TD><FONT SIZE=2>逻辑非</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>Not</FONT></TD></TR>

常数命名规格
早期的 VBScript 版本不能建立使用者自订常数。如果需要使用常数时,通常都是以一变数
来当作常数,同时使用全部大写的字母来命名以和一般的变数区别。而每个字之间则使用底
线( _ )字元来做区隔。比如像: 
 USER_LIST_MAX
 NEW_LINE

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Empty</B></FONT></TD>
<TD><FONT SIZE=2>未初始化的 <B>Variant</B>。对于数值变量,值为 0;对于字符串变量,值为零长度字符串 (“”)。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>负号</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>-</FONT></TD>
   <TD><FONT SIZE=2>不等于</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2><></FONT></TD>
<TD><FONT SIZE=2>逻辑与</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>And</FONT></TD></TR>

虽然现在这仍是一个辨别常数的可行办法,但因为现在可以使用 Const 陈述式来建立一个
真正的常数,所以您可能会希望改用另一种命名的架构。这个方式混合了大小写字母,同时
在常数之前加了一个「con」当作字首。比如像: 
 conYourOwnConstant

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Null</B></FONT></TD>
<TD><FONT SIZE=2>不包含任何有效数据的 <B>Variant</B>。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>乘</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>*</FONT></TD>
<TD><FONT SIZE=2>小于</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2><</FONT></TD>
<TD><FONT SIZE=2>逻辑或</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>Or</FONT></TD></TR>

变数命名规格
为了维持程式的可读性和一致性,请您在您的 VBScript 程式码内的变数名称前,加上下述
的字首。
[code]

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Boolean</B></FONT></TD>
<TD><FONT SIZE=2>包含 <B>True</B> 或 <B>False</B>。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>除</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>/</FONT></TD>
<TD><FONT SIZE=2>大于</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>></FONT></TD>
<TD><FONT SIZE=2>逻辑异或</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>Xor</FONT></TD></TR>

<TABLE WIDTH=60% BORDER=1 CELLPADDING=5 CELLSPACING=0>
<TR BGCOLOR=#DDDDDD VALIGN=TOP>
<TD><FONT SIZE=”2″><B>子型态</B></FONT></TD>
<TD><FONT SIZE=”2″><B>字首</B></FONT></TD>
<TD><FONT SIZE=”2″><B>范例</B></FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Byte</B></FONT></TD>
<TD><FONT SIZE=2>包含 0 到 255 之间的整数。</FONT></TD></TR>
<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Integer</B></FONT></TD>
<TD><FONT SIZE=2>包含 -32,768 到 32,767 之间的整数。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>整除</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2></FONT></TD>
<TD><FONT SIZE=2>小于等于</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2><=</FONT></TD>
<TD><FONT SIZE=2>逻辑等价</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>Eqv</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Boolean</FONT></TD>
<TD><FONT SIZE=”2″>bln</FONT></TD>
<TD><FONT SIZE=”2″>blnFound</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Currency</B></FONT></TD>
<TD><FONT SIZE=2>-922,337,203,685,477.5808 到 922,337,203,685,477.5807。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>求余</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>Mod</FONT></TD>
<TD><FONT SIZE=2>大于等于</FONT></TD>
澳门新葡萄京娱乐场,<TD ALIGN=CENTER><FONT SIZE=2>>=</FONT></TD>
<TD><FONT SIZE=2>逻辑隐含</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>Imp</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Byte</FONT></TD>
<TD><FONT SIZE=”2″>byt</FONT></TD>
<TD><FONT SIZE=”2″>bytRasterData</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Long</B></FONT></TD>
<TD><FONT SIZE=2>包含 -2,147,483,648 到 2,147,483,647 之间的整数。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>加</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>+</FONT></TD>
<TD><FONT SIZE=2>对象引用比较</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>Is</FONT></TD>
<TD><FONT SIZE=2>  </FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>  </FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Date (Time)</FONT></TD>
<TD><FONT SIZE=”2″>dtm</FONT></TD>
<TD><FONT SIZE=”2″>dtmStart</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Single</B></FONT></TD>
<TD><FONT SIZE=2>包含单精度浮点数,负数范围从 -3.402823E38 到 -1.401298E-45,正数范围从 1.401298E-45 到 3.402823E38。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>减</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>-</FONT></TD>
<TD><FONT SIZE=2>  </FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>  </FONT></TD>
<TD><FONT SIZE=2>  </FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>  </TD></FONT></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Double</FONT></TD>
<TD><FONT SIZE=”2″>dbl</FONT></TD>
<TD><FONT SIZE=”2″>dblTolerance</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2><B>Double</B></FONT></TD>
<TD><FONT SIZE=2>包含双精度浮点数,负数范围从 -1.79769313486232E308 到 -4.94065645841247E-324,正数范围从 4.94065645841247E-324 到 1.79769313486232E308。</FONT></TD></TR>
<TR  VALIGN=TOP>
<TD><FONT SIZE=2><B>Date (Time)</B></FONT></TD>
<TD><FONT SIZE=2>包含表示日期的数字,日期范围从公元 100 年 1 月 1 日到公元 9999 年 12 月 31 日。</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=2>字符串连接</FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>&</FONT></TD>
<TD><FONT SIZE=2>  </FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>  </FONT></TD>
<TD><FONT SIZE=2>  </FONT></TD>
<TD ALIGN=CENTER><FONT SIZE=2>  </FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Error</FONT></TD>
<TD><FONT SIZE=”2″>err</FONT></TD>
<TD><FONT SIZE=”2″>errOrderNum</FONT></TD></TR>

<TR  VALIGN=TOP>
<TD><FONT SIZE=2><B>String</B></FONT></TD>
<TD><FONT SIZE=2>包含变长字符串,最大长度可为 20 亿个字符。</FONT></TD></TR>

</TABLE>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Integer</FONT></TD>
<TD><FONT SIZE=”2″>int</FONT></TD>
<TD><FONT SIZE=”2″>intQuantity</FONT></TD></TR>

<TR  VALIGN=TOP>
<TD><FONT SIZE=2><B>Object</B></FONT></TD>
<TD><FONT SIZE=2>包含对象。</FONT></TD></TR>

<FONT SIZE=2>
当乘号与除号同时出现在一个表达式中时,按从左到右的顺序计算乘、除运算符。同样当加与减同时出现在一个表达式中时,按从左到右的顺序计算加、减运算符。<P>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Long</FONT></TD>
<TD><FONT SIZE=”2″>lng</FONT></TD>
<TD><FONT SIZE=”2″>lngDistance</FONT></TD></TR>

<TR  VALIGN=TOP>
<TD><FONT SIZE=2><B>Error</B></FONT></TD>
<TD><FONT SIZE=2>包含错误号。</FONT></TD></TR>
</TABLE>

字符串连接 (&) 运算符不是算术运算符,但是在优先级顺序中,它排在所有算术运算符之后和所有比较运算符之前。<B>Is</B> 运算符是对象引用比较运算符。它并不比较对象或对象的值,而只是进行检查,判断两个对象引用是否引用同一个对象。

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Object</FONT></TD>
<TD><FONT SIZE=”2″>obj</FONT></TD>
<TD><FONT SIZE=”2″>objCurrent</FONT></TD></TR>

您可以使用<A HREF=”237.htm”>转换函数</A>来转换数据的子类型。另外,可使用 <AB>VarType</B> 函数返回数据的 <B>Variant</B> 子类型。
</BLOCKQUOTE>

[/code]

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Single</FONT></TD>
<TD><FONT SIZE=”2″>sng</FONT></TD>
<TD><FONT SIZE=”2″>sngAverage</FONT></TD></TR>

[/code]

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>String</FONT></TD>
<TD><FONT SIZE=”2″>str</FONT></TD>
<TD><FONT SIZE=”2″>strFirstName</FONT></TD></TR>

</TABLE>
<H5>变数的有效范围</H5>
变数应该尽可能的定义在最小的有效范围之中。VBScript 变数有下列几种有效范围:<P>

<TABLE WIDTH=70% BORDER=1 CELLPADDING=5 CELLSPACING=0>
<TR BGCOLOR=#DDDDDD VALIGN=TOP>
<TD><FONT SIZE=”2″><B>有效范围</B></FONT></TD>
<TD><FONT SIZE=”2″><B>变数宣告的地点</B></FONT></TD>
<TD><FONT SIZE=”2″><B>可视性</B></FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>程序层级</FONT></TD>
<TD><FONT SIZE=”2″>事件,函数,或 Sub 程序</FONT></TD>
<TD><FONT SIZE=”2″>可见范围在其宣告的程序中</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Script 层级</FONT></TD>
<TD><FONT SIZE=”2″>HTML 网页的 HEAD 区段,需写在所有程序之外</FONT></TD>
<TD><FONT SIZE=”2″>Script 中的每一个程序都可见</FONT></TD></TR>
</TABLE>
<H5>变数有效范围字首</H5>

当 script 很大时,加上变数有效范围字首将可以快速区别变数的有效范围。<br>
一个置於型态字首之前的单一字母之有效范围字首可以帮我们做到这点,<br>
同时又不会过度的增加变数名称的长度。<P>

<TABLE WIDTH=70% BORDER=1 CELLPADDING=5 CELLSPACING=0>
<TR BGCOLOR=#DDDDDD VALIGN=TOP>
<TD><FONT SIZE=”2″><B>有效范围</B></FONT></TD>
<TD><FONT SIZE=”2″><B>字首</B></FONT></TD>
<TD><FONT SIZE=”2″><B>范例</B></FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>程序层级</FONT></TD>
<TD><FONT SIZE=”2″>不必加</FONT></TD>
<TD><FONT SIZE=”2″>dblVelocity</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Script 层级</FONT></TD>
<TD><FONT SIZE=”2″>s</FONT></TD>
<TD><FONT SIZE=”2″>sblnCalcInProgress</FONT></TD></TR>

</TABLE>

</BLOCKQUOTE>

<H5>有说明性的变数和程序名称</H5>

变数和程序名称应该使用大小写混合的命名名称,<br>
同时这个名称应该尽可能地能够说明变数的用途。<br>
此外,程序名称应该以动词开头,比如像 InitNameArray 或 CloseDialog。<P>

对於一些经常使用的长名词,我们建议您使用标准的缩写,以免名称过长。<br>
一般来说,名称长度如果超过32 个字元就很难阅读。当您使用缩写时,<br>
请在全部的script 中都保持相同的缩写方式。举例来说,<br>
如果您在一个 script 或一组 script 中时而用 Cnt,时而用Count,<br>
那麽有时可能会造成困扰。<br>

<H5>物件命名规格 </H5>
下清单格列出了您在撰写 VBScript 时会遭遇的物件型态及建议的命名规格。<P>

<TABLE WIDTH=70% BORDER=1 CELLPADDING=5 CELLSPACING=0>
<TR BGCOLOR=#DDDDDD VALIGN=TOP>
<TD><FONT SIZE=”2″><B>物件型态</B></FONT></TD>
<TD><FONT SIZE=”2″><B>字首</B></FONT></TD>
<TD><FONT SIZE=”2″><B>范例</B></FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>3D Panel</FONT></TD>
<TD><FONT SIZE=”2″>pnl</FONT></TD>
<TD><FONT SIZE=”2″>pnlGroup</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Animated button</FONT></TD>
<TD><FONT SIZE=”2″>ani</FONT></TD>
<TD><FONT SIZE=”2″>aniMailBox</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Check box</FONT></TD>
<TD><FONT SIZE=”2″>chk</FONT></TD>
<TD><FONT SIZE=”2″>chkReadOnly</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Combo box, drop-down list box</FONT></TD>
<TD><FONT SIZE=”2″>cbo</FONT></TD>
<TD><FONT SIZE=”2″>cboEnglish</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Command button</FONT></TD>
<TD><FONT SIZE=”2″>cmd</FONT></TD>
<TD><FONT SIZE=”2″>cmdExit</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Common dialog</FONT></TD>
<TD><FONT SIZE=”2″>dlg</FONT></TD>
<TD><FONT SIZE=”2″>dlgFileOpen</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Frame</FONT></TD>
<TD><FONT SIZE=”2″>fra</FONT></TD>
<TD><FONT SIZE=”2″>fraLanguage</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Horizontal scroll bar</FONT></TD>
<TD><FONT SIZE=”2″>hsb</FONT></TD>
<TD><FONT SIZE=”2″>hsbVolume</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Image</FONT></TD>
<TD><FONT SIZE=”2″>img</FONT></TD>
<TD><FONT SIZE=”2″>imgIcon</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Label</FONT></TD>
<TD><FONT SIZE=”2″>lbl</FONT></TD>
<TD><FONT SIZE=”2″>lblHelpMessage</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Line</FONT></TD>
<TD><FONT SIZE=”2″>lin</FONT></TD>
<TD><FONT SIZE=”2″>linVertical</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>List Box</FONT></TD>
<TD><FONT SIZE=”2″>lst</FONT></TD>
<TD><FONT SIZE=”2″>lstPolicyCodes</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Spin</FONT></TD>
<TD><FONT SIZE=”2″>spn</FONT></TD>
<TD><FONT SIZE=”2″>spnPages</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Text box</FONT></TD>
<TD><FONT SIZE=”2″>txt</FONT></TD>
<TD><FONT SIZE=”2″>txtLastName</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Vertical scroll bar</FONT></TD>
<TD><FONT SIZE=”2″>vsb</FONT></TD>
<TD><FONT SIZE=”2″>vsbRate</FONT></TD></TR>

<TR VALIGN=TOP>
<TD><FONT SIZE=”2″>Slider</FONT></TD>
<TD><FONT SIZE=”2″>sld</FONT></TD>
<TD><FONT SIZE=”2″>sldScale</FONT></TD></TR>
</TABLE>

<H5>程式注解规格</H5>
所有的程序都应该以一简短的注解当作开头来解释程序的功用。这些说明不必解释程式制作<br>
的细节 (它怎麽做到的), 因为这些内容可能时时会改变。如此一来,您就不必做一些不必<br>
要的注解维护工作,或是让您的注解错误百出。这些程式码本身和所有必要的行间注解就足<br>
以说明制作的方式。 <P>

当要传递到程序中的引数之目的不是很明显时,或是程序预期引数的值应该介於某个范围之<br>
间时,您就应该在注解中说明。函数的传回值以及会被程序更动的变数,特别是经由引用的<br>
引数,也都应该写在程序的前头的注解中。<P>

程序的开头注解应该包含下列几个区段标题。您可以叁考以下「格式化您的程式码」中的例<br>子。<P>

<TABLE WIDTH=70% BORDER=1 CELLPADDING=5 CELLSPACING=0>
<TR BGCOLOR=#DDDDDD VALIGN=TOP>
<TD WIDTH=15%><FONT SIZE=”2″><B>区段标题</B></FONT></TD>
<TD><FONT SIZE=”2″><B>注解内容</B></FONT></TD>

<TR VALIGN=TOP>
<TD WIDTH=15%><FONT SIZE=”2″>目的(Purpose)</FONT></TD>
<TD><FONT SIZE=”2″>程序的功用(不是如何达成其功用)。</FONT></TD>

<TR VALIGN=TOP>
<TD WIDTH=15%><FONT SIZE=”2″>假设(Assumptions)</FONT></TD>
<TD><FONT SIZE=”2″>列出任何会影响这个程序的外部变数、控制项或其它元件。</FONT></TD>

<TR VALIGN=TOP>
<TD WIDTH=15%><FONT SIZE=”2″>影响(Effects)</FONT></TD>
<TD><FONT SIZE=”2″>列出这个程序会影响的任何外部变数、控制项或其它元件。</FONT></TD>

<TR VALIGN=TOP>
<TD WIDTH=15%><FONT SIZE=”2″>输入(Inputs)</FONT></TD>
<TD><FONT SIZE=”2″>解释每一个没有明显功能的引数。每一个引数都应该自成一行,同时使用行间注解。</FONT></TD>

<TR VALIGN=TOP>
<TD WIDTH=15%><FONT SIZE=”2″>传回值(Return Values)</FONT></TD>
<TD><FONT SIZE=”2″>解释传回值的意义。</FONT></TD>
</TABLE>

请记得下列几个要点:
<UL>
<LI>每一个重要变数的宣告都应该伴随着一个行间注解来说明变数的功用。<br>
<LI>变数、控制项和程序的名称都应该要令人可以一目了然。行间注解只需要用在一些较复<br>
杂的程式细节部分。 
<LI>在 script 的开头,您应该包含一段描述整个 script 的概观,同时列举物件、程序、<br>
演算法、对话方块以及其它和系统相关的事项。有时用一段虚拟码来说明演算法可能会有不<br>
小的帮助。
</UL>

<H5>格式化您的程式码</H5>
<BLOCKQUOTE>
尽可能保留萤幕的空间,但是同时要让您的程式格式可以反映程式的逻辑结构和巢状架构。<br>
这里有几个要点:
<UL>
<LI>标准的巢状区块应该用四个空格缩排。  <br>
<LI>一个程序的概观注解应该用一个空格缩排。
<br><LI>紧接在概观注解後的最高层级陈述式应该要用四个空格缩排,其中的巢状区块则再<br>用四
个空格缩排。
下面是一个例子:
</UL>
[/code]
 ‘*********************************************************
 ‘ Purpose:  Locates the first occurrence of a specified user 
 ‘           in the UserList array.
 ‘ Inputs:   strUserList():   the list of users to be searched.
 ‘           strTargetUser:   the name of the user to search for.
 ‘ Returns:  The index of the first occurrence of the strTargetUser 
 ‘           in the strUserList array. 
 ‘           If the target user is not found, return -1.
 ‘*********************************************************

 Function intFindUser (strUserList(), strTargetUser)
     Dim i                     ‘ Loop counter.
     Dim blnFound        ‘ Target found flag
     intFindUser = -1
     i = 0                     ‘ Initialize loop counter
     Do While i <= Ubound(strUserList) and Not blnFound
         If strUserList(i) = strTargetUser Then 
             blnFound = True   ‘ Set flag to True
             intFindUser = i   ‘ Set return value to loop count
         End If
         i = i + 1             ‘ Increment loop counter
     Loop
 End Function

发表评论

电子邮件地址不会被公开。 必填项已用*标注