Function 문(Visual Basic)

프로시저를 정의하는 이름, 매개 변수 및 코드를 선언합니다 Function .

Syntax

[ <attributelist> ] [ accessmodifier ] [ proceduremodifiers ] [ Shared ] [ Shadows ] [ Async | Iterator ]
Function name [ (Of typeparamlist) ] [ (parameterlist) ] [ As returntype ] [ Implements implementslist | Handles eventlist ]
    [ statements ]
    [ Exit Function ]
    [ statements ]
End Function

부분

• attributelist

  선택 사항입니다. 특성 목록을 참조하세요.

• accessmodifier

  선택 사항입니다. 다음 중 하나일 수 있습니다.

  • 공용

  • Protected

  • Friend

  • 개인

  • Protected Friend

  • 프라이빗 보호됨

  Access levels in Visual Basic을 참조하세요.

• proceduremodifiers

  선택 사항입니다. 다음 중 하나일 수 있습니다.

  • 오버로드

  • 재정의

  • Overrides

  • NotOverridable

  • New

  • MustOverride Overrides

  • NotOverridable Overrides

• Shared

  선택 사항입니다. 공유를 참조하세요.

• Shadows

  선택 사항입니다. 그림자를 참조하세요.

• Async

  선택 사항입니다. 비동기 를 참조하세요.

• Iterator

  선택 사항입니다. 반복기를 참조하세요.

• name

  필수 사항입니다. 프로시저의 이름입니다. Declared Element Names을 참조하세요.

• typeparamlist

  선택 사항입니다. 제네릭 프로시저의 형식 매개 변수 목록입니다. 형식 목록을 참조하세요.

• parameterlist

  선택 사항입니다. 이 절차의 매개 변수를 나타내는 지역 변수 이름 목록입니다. 매개 변수 목록을 참조하세요.

• returntype

  필요한 경우 Option Strict 는 On합니다. 이 프로시저에서 반환된 값의 데이터 형식입니다.

• Implements

  선택 사항입니다. 이 프로시저가 하나 이상의 Function 프로시저를 구현한다는 것을 나타내며, 각 프로시저는 이 프로시저의 포함하는 클래스 또는 구조체에 의해 구현된 인터페이스에 정의되어 있습니다. 구현 문을 참조하세요.

• implementslist

  Implements가 제공된 경우 필수입니다. 구현할 Function 프로시저 목록입니다.

  implementedprocedure [ , implementedprocedure ... ]

  각 implementedprocedure에는 다음과 같은 구문과 요소가 있습니다.

  interface.definedname

  부분	Description
  interface	필수 사항입니다. 클래스 또는 구조를 포함하는 이 프로시저에서 구현된 인터페이스의 이름입니다.
  definedname	필수 사항입니다. 프로시저가 interface에 정의되는 이름입니다.

• Handles

  선택 사항입니다. 이 프로시저가 하나 이상의 특정 이벤트를 처리할 수 있음을 나타냅니다. 핸들을 참조하세요.

• eventlist

  Handles가 제공된 경우 필수입니다. 이 프로시저가 처리하는 이벤트 목록입니다.

  eventspecifier [ , eventspecifier ... ]

  각 eventspecifier에는 다음과 같은 구문과 요소가 있습니다.

  eventvariable.event

  부분	Description
  eventvariable	필수 사항입니다. 이벤트를 발생시키는 클래스 또는 구조체의 데이터 형식으로 선언된 개체 변수입니다.
  event	필수 사항입니다. 이 프로시저가 처리하는 이벤트의 이름입니다.

• statements

  선택 사항입니다. 이 프로시저 내에서 실행할 문의 블록입니다.

• End Function

  이 절차의 정의를 종료합니다.

설명

모든 실행 코드는 프로시저 내에 있어야 합니다. 각 프로시저는 클래스, 구조체 또는 포함하는 클래스, 구조체 또는 모듈이라고 하는 모듈 내에서 선언됩니다.

호출 코드에 값을 반환하려면 프로시저를 Function 사용합니다. 그렇지 않으면 프로시저를 Sub 사용합니다.

함수 정의

모듈 수준에서만 프로시저를 정의 Function 할 수 있습니다. 따라서 함수의 선언 컨텍스트는 클래스, 구조체, 모듈 또는 인터페이스여야 하며 소스 파일, 네임스페이스, 프로시저 또는 블록일 수 없습니다. 자세한 내용은 선언 컨텍스트 및 기본 액세스 수준을 참조하세요.

Function 프로시저는 기본적으로 공용 액세스로 설정됩니다. 액세스 한정자를 사용하여 액세스 수준을 조정할 수 있습니다.

프로시저는 Function 프로시저가 반환하는 값의 데이터 형식을 선언할 수 있습니다. 모든 데이터 형식 또는 열거형의 이름, 구조체, 클래스 또는 인터페이스를 지정할 수 있습니다. 매개 변수를 returntype 지정하지 않으면 프로시저가 를 반환합니다 Object.

이 프로시저에서 Implements 키워드(keyword) 사용하는 경우 포함하는 클래스 또는 구조체에는 Implements 또는 Structure 문 바로 뒤에 Class 오는 문도 있어야 합니다. 문에는 Implements 에 implementslist지정된 각 인터페이스가 포함되어야 합니다. 그러나 인터페이스가 를 정의하는 Function 이름(의 definedname)은 이 프로시저의 이름(의 name)과 일치할 필요가 없습니다.

참고

람다 식을 사용하여 함수 식을 인라인으로 정의할 수 있습니다. 자세한 내용은 함수 식 및 람다 식을 참조하세요.

함수에서 반환

프로시저가 Function 호출 코드로 돌아오면 프로시저를 호출한 문 뒤에 있는 문으로 실행이 계속됩니다.

함수에서 값을 반환하려면 함수 이름에 값을 할당하거나 문에 Return 포함할 수 있습니다.

문은 Return 반환 값을 동시에 할당하고 다음 예제와 같이 함수를 종료합니다.

Function MyFunction(ByVal j As Integer) As Double
    Return 3.87 * j
End Function

다음 예제에서는 함수 이름 myFunction 에 반환 값을 할당한 다음 문을 사용하여 Exit Function 반환합니다.

Function MyFunction(ByVal j As Integer) As Double
    MyFunction = 3.87 * j
    Exit Function
End Function

및 문은 Exit Function 프로시저에서 즉시 종료됩니다Function.Return 모든 수의 Exit Function 및 Return 문이 프로시저의 아무 곳에나 나타날 수 있으며 및 Return 문을 혼합 Exit Function 할 수 있습니다.

에 값을 name할당하지 않고 를 사용하는 Exit Function 경우 프로시저는 에 returntype지정된 데이터 형식의 기본값을 반환합니다. 를 지정하지 않으면 returntype 프로시저는 의 기본값Object인 를 반환Nothing합니다.

함수 호출

프로시저 이름을 사용한 다음 식에서 인수 목록을 괄호로 하여 프로시저를 호출 Function 합니다. 인수를 제공하지 않는 경우에만 괄호를 생략할 수 있습니다. 그러나 항상 괄호를 포함하는 경우 코드를 더 쉽게 읽을 수 있습니다.

, 또는 와 같은 라이브러리 함수를 호출하는 것과 동일한 방식으로 프로시저를 SqrtCos호출 Function 합니다ChrW.

키워드(keyword) 사용하여 함수를 호출할 Call 수도 있습니다. 이 경우 반환 값은 무시됩니다. Call 대부분의 경우 키워드(keyword) 사용하지 않는 것이 좋습니다. 자세한 내용은 통화 문을 참조하세요.

Visual Basic은 경우에 따라 산술 식을 다시 정렬하여 내부 효율성을 높입니다. 따라서 함수가 동일한 식의 변수 값을 변경하는 경우 산술 식에서 프로시저를 사용하면 Function 안 됩니다.

비동기 함수

비동기 기능을 사용하면 명시적 콜백을 사용하거나 여러 함수 또는 람다 식 간에 코드를 수동으로 분할하지 않고도 비동기 함수를 호출할 수 있습니다.

Async 한정자로 함수를 표시하는 경우 함수에서 Await 연산자를 사용할 수 있습니다. 컨트롤이 함수의 Await 식에 Async 도달하면 컨트롤이 호출자에게 반환되고 대기 중인 작업이 완료될 때까지 함수의 진행률이 일시 중단됩니다. 작업이 완료되면 함수에서 실행을 다시 시작할 수 있습니다.

참고

프로시저는 Async 아직 완료되지 않은 첫 번째 대기 개체가 발견되거나 프로시저의 Async 끝에 도달하면 호출자에게 반환됩니다.

함수는 Async 또는 Task의 Task<TResult> 반환 형식을 가질 수 있습니다. 반환 형식 Task<TResult> 이 Async 인 함수의 예는 다음과 같습니다.

함수는 AsyncByRef 매개 변수를 선언할 수 없습니다.

하위 문은 한정자를 사용하여 Async 표시할 수도 있습니다. 이는 주로 값을 반환할 수 없는 이벤트 처리기에 사용됩니다. 프로시저를 AsyncSub 대기할 수 없으며 프로시저의 AsyncSub 호출자는 프로시저에서 throw Sub 된 예외를 catch할 수 없습니다.

함수에 대한 Async 자세한 내용은 Async 및 Await를 사용한 비동기 프로그래밍, 비동기 프로그램의 제어 흐름 및 비동기 반환 형식을 참조하세요.

반복기 함수

반복기 함수는 목록 또는 배열과 같은 컬렉션에 대해 사용자 지정 반복을 수행합니다. 반복기 함수는 Yield 문을 사용하여 각 요소를 한 번에 하나씩 반환합니다. Yield 문에 도달하면 코드의 현재 위치가 기억됩니다. 다음에 반복기 함수가 호출되면 해당 위치에서 실행이 다시 시작됩니다.

For Each...를 사용하여 클라이언트 코드에서 반복기를 호출 합니다. 다음 문입니다.

반복기 함수의 반환 형식은 , , IEnumerable<T>IEnumerator또는 IEnumerator<T>일 IEnumerable수 있습니다.

자세한 내용은 반복기를 참조하세요.

예 1

다음 예제에서는 문을 사용하여 Function 프로시저 본 Function 문을 구성하는 이름, 매개 변수 및 코드를 선언합니다. ParamArray 한정자를 사용하면 함수가 가변 개수의 인수를 수락할 수 있습니다.

Public Function CalcSum(ByVal ParamArray args() As Double) As Double
    CalcSum = 0
    If args.Length <= 0 Then Exit Function
    For i As Integer = 0 To UBound(args, 1)
        CalcSum += args(i)
    Next i
End Function

예제 2

다음 예제에서는 앞의 예제에서 선언된 함수를 호출합니다.

Module Module1

    Sub Main()
        ' In the following function call, CalcSum's local variables
        ' are assigned the following values: args(0) = 4, args(1) = 3,
        ' and so on. The displayed sum is 10.
        Dim returnedValue As Double = CalcSum(4, 3, 2, 1)
        Console.WriteLine("Sum: " & returnedValue)
        ' Parameter args accepts zero or more arguments. The sum
        ' displayed by the following statements is 0.
        returnedValue = CalcSum()
        Console.WriteLine("Sum: " & returnedValue)
    End Sub

    Public Function CalcSum(ByVal ParamArray args() As Double) As Double
        CalcSum = 0
        If args.Length <= 0 Then Exit Function
        For i As Integer = 0 To UBound(args, 1)
            CalcSum += args(i)
        Next i
    End Function

End Module

예제 3

다음 예제에서 는 DelayAsyncAsyncFunction 반환 형식 Task<TResult>이 인 입니다. DelayAsync 에는 정수를 반환하는 Return 문이 포함됩니다. 따라서 의 함수 선언에는 DelayAsync 의 반환 형식 Task(Of Integer)이 있어야 합니다. 반환 형식이 이므로 Task(Of Integer)의 식 계산 Await 은 DoSomethingAsync 정수 를 생성합니다. 이 설명은 에 설명되어 있습니다 Dim result As Integer = Await delayTask.

startButton_Click 프로시저는 프로시저의 예입니다Async Sub. DoSomethingAsync 는 함수이므로 Async 다음 문에서 알 Await DoSomethingAsync()수 DoSomethingAsync 있듯이 에 대한 호출 태스크를 대기해야 합니다. 프로시저는 startButton_ClickSub 식이 Async 있으므로 한정자를 Await 사용하여 정의해야 합니다.

' Imports System.Diagnostics
' Imports System.Threading.Tasks

' This Click event is marked with the Async modifier.
Private Async Sub startButton_Click(sender As Object, e As RoutedEventArgs) Handles startButton.Click
    Await DoSomethingAsync()
End Sub

Private Async Function DoSomethingAsync() As Task
    Dim delayTask As Task(Of Integer) = DelayAsync()
    Dim result As Integer = Await delayTask

    ' The previous two statements may be combined into
    ' the following statement.
    ' Dim result As Integer = Await DelayAsync()

    Debug.WriteLine("Result: " & result)
End Function

Private Async Function DelayAsync() As Task(Of Integer)
    Await Task.Delay(100)
    Return 5
End Function

'  Output:
'   Result: 5

참고 항목

• Sub 문
• 함수 프로시저
• 매개 변수 목록
• Dim 문
• Call 문
• 의
• 매개 변수 배열
• 방법: 제네릭 클래스 사용
• 프로시저 문제 해결
• 람다 식
• 함수 식