Spis treści
Indeks 🔎︎

# Instrukcja Function

Funkcja to blok kodu, który jest uruchamiany po wywołaniu. Funkcja jest zwykle wywoływana w wyrażeniu.

Do funkcji można przekazywać dane, zwane parametrami lub argumentami. Możesz przekazać parametr przez wartość lub przez odwołanie. Gdy przez odwołanie, modyfikacje zastosowane do parametru w funkcji zostaną odesłane z powrotem do kodu wywołującego.

Funkcja zwykle zwraca dane jako wynik.

### Składnia:

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

### Parametry:

scope: Domyślny zakres funkcji to Public. Zakres Private oznacza wewnętrzną procedurę modułu, która nie jest przeznaczona do użycia z innymi modułami.

name: Nazwa podprogramu, który ma zawierać wartość zwróconą przez funkcję.

arguments: Parametry, które mają zostać przekazane do podprogramu standardowego.

##### argument fragment

          {[Optional [ByRef|ByVal]]|ParamArray} argument {{As typename|char}[ = expression]|[()]As Variant}

##### Parameters

Optional: The argument is not mandatory.

ByRef: The argument is passed by reference. ByRef is the default.

ByVal: The argument is passed by value. Its value can be modified by the called routine.

char: Type declaration character.

typename: Primitive data type name. Library or module defined types can also be specified.

= expression: Specify a default value for the argument, matching its declared type. Optional is necessary for each argument specifying a default value.

ParamArray: Use ParamArray when the number of parameters is undetermined. A typical scenario is that of a Calc user-defined function. Using ParamArray should be limited to the last argument of a routine.

UsingParamArray or = expression require Option Compatible to be placed before the executable program code in a module.

When using Option VBASupport 1, Optional arguments with no default value (= expression) are initialized according to their data type, except if Variant.

##### typename fragment

          {Boolean|Byte|Currency|Date|Double|Integer|Long|Object|Single|String|Variant}

##### char fragment

          { % | & | ! | # | $ | @ }

## Przykłady:

    Sub ExampleExit
    Dim sReturn As String
    Dim sListArray(10) As String
    Dim siStep As Single
        For siStep = 0 to 10 ' Wypełnienie tablicy danymi testowymi
            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
    ' Funkcja Linsearch poszukuje wyrażenia TextEntry w tablicy TextArray:sList():
    ' Wynikiem funkcji jest indeks wystąpienia wyrażenia lub wartość 0 (Null)
        For iCount=1 To Ubound( sList() )
            If sList( iCount ) = sItem Then
                Exit For ' Odnalezione wyrażenie sItem
            End If
        Next iCount
        If iCount = Ubound( sList() ) Then iCount = 0
        LinSearch = iCount
    End Function

Tematy pokrewne

Podstawy podprogramów

Używanie procedur, funkcji i właściwości

Instrukcja Sub

Property Statement