Function 語句

Microsoft® Visual Basic® Scripting Edition Function 語句

語言參考 啓始頁|版本 1

請參閱

描述

聲明 Function 過程的名稱、參數以及構成其主體的代碼。

語法

[Public | Private] Function name [(arglist)]
[statements]
[name = expression]
[Exit Function]
[statements]
[name = expression]
End Function

Function 語句的語法包含以下部分：

部分	描述
Public	表示 Function 過程可被所有 Script 中的所有其他過程訪問。
Private	表示 Function 過程只可被聲明它的 Script 中的其他過程訪問。
name	Function 的名稱，遵循標準的變量命名約定。
arglist	代表調用時要傳遞給 Function 過程的參數的變量列表。用逗號隔開多個變量。
statements	在 Function 過程的主體中執行的任意語句組。
expression	Function 的返回值。

arglist 參數包含下列語法和部分：

[ByVal | ByRef] varname[( )]

部分	描述
ByVal	表示該參數按值傳遞。
ByRef	表示該參數按引用傳遞。
varname	代表參數變量的名稱；遵循標準的變量命名約定。

說明

如沒有顯式指定使用 Public 或 Private，則 Function 過程默認爲公用，即它們對於 Script 中的所有其他過程是可見的。Function 中局部變量的值在對過程的調用中不被保留。

所有可執行代碼必須包含於過程中。不能在另一個 Function 或 Sub 過程中定義 Function 過程。

使用 Exit Function 語句可以從 Function 過程中立即退出。程序繼續執行調用 Function 過程的語句之後的語句。可在 Function 過程的任何位置出現任意個 Exit Function 語句。

與 Sub 過程類似，Function 過程是可以獲取參數、執行一系列語句並改變其參數值的獨立過程。與 Sub 過程的不同之處是：當要使用由函數返回的值時，可以在表達式的右邊使用 Function 過程，這與內部函數的使用方式一樣，例如 Sqr、Cos 或 Chr。

在表達式中，可以通過使用函數名，並在其後用圓括號給出相應的參數列表來調用 Function 過程。有關調用 Function 過程的詳細信息，請參閱 Call 語句。

---

小心 Function 過程可以是遞歸的，即該過程可以調用自身以完成某個給定的任務。但是，遞歸可能會導致堆棧溢出。

---

要從函數返回一個值，只需將值賦給函數名。在過程的任意位置都可以出現任意個這樣的賦值。如果沒有給 name 賦值, 則過程將返回一個默認值：數值函數返回 0，字符串函數返回零長度字符串 ("")。如果在 Function 中沒有對象引用被指定給 name（使用 Set)，則返回對象引用的函數將返回 Nothing。

下面的樣例說明如何給一個名爲 BinarySearch 的函數賦返回值。在此樣例中，將 False 賦給了該函數名，表示沒有找到某個值。

Function BinarySearch(. . .)
    . . .
    ' 未找到該值。返回 False 值。
    If lower > upper Then
        BinarySearch = False  
        Exit Function 
    End If
    . . .
End Function

在 Function 過程中使用的變量分爲兩類：一類是在過程內顯式聲明的，另一類則不是。在過程內顯式聲明的變量（使用 Dim 或等效方法）總是過程的局部變量。被使用但沒有在過程中顯式聲明的變量也是局部變量，除非在該過程外更高級別的位置顯式聲明它們。

---

小心 過程可以使用沒有在過程內顯式聲明的變量，但如果在 Script 級中任何定義的名稱與之相同，則會發生名稱衝突。如果過程中使用的未聲明的變量與另一個過程、常數或變量的名稱相同，則會認爲過程使用的是 Script 級的名稱。顯式聲明變量可以避免這類衝突。可以使用 Option Explicit 語句來強制顯式聲明變量。

---

---

小心 VBScript 可能會重新排列數學表達式以提高內部效率。當 Function 過程修改數學表達式中變量的值時，應避免在同一表達式中使用該函數。