Function Statement

A function is a block of code which runs when it is called. A function is usually called in an expression. You can pass data, known as parameters or arguments, into a function. You may pass a parameter by value or by reference. When by reference, modifications applied to the parameter in the function will be sent back to the calling code. A function usually returns data as a result.

Function Statement diagram [Private | Public] Function Name[char] (argument1 [As Type][, argument2[char][,...]]) [As typename] statements [Exit Function] statements End Function

scope: Function default scope is Public. A Private scope denotes a module internal routine, not intended to be used from other modules.

name: Name of the subroutine to contain the value returned by the function. arguments: Parameters to be passed to the subroutine.

Examples:

Sub ExampleExit Dim sReturn As String Dim sListArray(10) As String Dim siStep As Single For siStep = 0 To 10 ' Fill array with test data sListArray(siStep) = chr$(siStep + 65) MsgBox sListArray(siStep) Next siStep sReturn = LinSearch(sListArray(), "B") Print sReturn End Sub Function LinSearch( sList(), sItem As String ) As Integer Dim iCount As Integer ' Linsearch searches a TextArray:sList() for a TextEntry: ' Return value Is the index of the entry Or 0 (Null) For iCount=1 To Ubound( sList() ) If sList( iCount ) = sItem Then Exit For ' sItem found End If Next iCount If iCount = Ubound( sList() ) Then iCount = 0 LinSearch = iCount End Function

Subroutines basics