|
什么是編碼約定？ 編碼約定是幫助您使用 Microsoft Visual Basic Scripting Edition 編寫代碼的一些建議。編碼約定包含以下內容：
變量作用域 變量應定義在盡量小的作用域中。VBScript 變量的作用域如下所示：
變量作用域前綴 隨著 Script 代碼長度的增加，有必要快速區分變量的作用域。在類型前綴前面添加一個單字符前綴可以實現這一點，而不致使變量名過長。
描述性變量名和過程名 變量名或過程名的主體應使用大小寫混合格式，并且盡量完整地描述其目的。另外，過程名應以動詞開始，例如 InitNameArray 或 CloseDialog。 對于經常使用的或較長的名稱，推薦使用標準縮寫以使名稱保持在適當的長度內。通常多于 32 個字符的變量名會變得難以閱讀。使用縮寫時，應確保在整個 Script 中保持一致。例如，在一個 Script 或 Script 集中隨意切換 Cnt 和 Count 將造成混亂。 對象命名約定 下表列出了 VBScript 中可能用到的對象命名約定（推薦）：
代碼注釋約定 所有過程的開始部分都應有描述其功能的簡要注釋。這些注釋并不描述細節信息（如何實現功能），這是因為細節有時要頻繁更改。這樣就可以避免不必要的注釋維護工作以及錯誤的注釋。細節信息由代碼本身及必要的內部注釋來描述。 當傳遞給過程的參數的用途不明顯，或過程對參數的取值范圍有要求時，應加以說明。如果過程改變了函數和變量的返回值（特別是通過參數引用來改變），也應在過程的開始部分描述該返回值。 過程開始部分的注釋應包含以下區段標題。相關樣例，請參閱后面的“格式化代碼”部分。
請記住以下幾點： ·每個重要的變量聲明都應有內部注釋，描述變量的用途。 ·應清楚地命名變量、控件和過程，僅在說明復雜細節時需要內部注釋。 ·應在 Script 的開始部分包含描述該 Script 的概述，列舉對象、過程、運算法則、對話框和其他系統從屬物。有時一段描述運算法則的假碼是很有用的。 格式化代碼 應盡可能多地保留屏空間，但仍允許用代碼格式反映邏輯結構和嵌套。以下為幾點提示： ·標準嵌套塊應縮進 4 個空格。 ·過程的概述注釋應縮進 1 個空格。 ·概述注釋后的最高層語句應縮進 4 個空格，每一層嵌套塊再縮進 4 個空格。例如： '********************************************************* ' 目的： 返回指定用戶在 UserList 數組中第一次出現的位置。 ' 輸入： strUserList(): 所查找的用戶列表。 ' strTargetUser: 要查找的用戶名。 ' 返回： strTargetUser 在 strUserList 數組中第一次出現時的索引。 ' 如果目標用戶未找到，返回 -1。 '********************************************************* Function intFindUser (strUserList(), strTargetUser) Dim i ' 循環計數器。 Dim blnFound ' 發現目標的標記。 intFindUser = -1 i = 0 ' 初始化循環計數器。 Do While i <= Ubound(strUserList) and Not blnFound If strUserList(i) = strTargetUser Then blnFound = True ' 標記設為 True。 intFindUser = i ' 返回值設為循環計數器。 End If i = i + 1 ' 循環計數器加 1。 Loop End Function |
溫馨提示：喜歡本站的話，請收藏一下本站！
本站發布的Win7純凈版系統、Win10純凈版和XP純凈版系統僅為個人學習測試使用，請在下載后24小時內刪除，不得用于任何商業用途，否則后果自負，請支持購買微軟正版軟件！
本站所有資源全部來自于網絡資源,如侵犯到您的權益,請及時通知我們(),我們會及時處理.
Copyright © 2018-2020 蘿卜系統下載站 手機站 關于本站
