Yield 문(Visual Basic)

컬렉션의 다음 요소를 For Each...Next 문으로 보냅니다.

구문

Yield expression  

매개 변수

용어	정의
expression	필수입니다. 반복기 함수 또는 Yield 문을 포함하는 Get 접근자의 형식으로 암시적으로 변환할 수 있는 식입니다.

설명

Yield 문은 컬렉션의 한 요소를 한 번에 하나씩 반환합니다. Yield 문은 컬렉션에 대해 사용자 지정 반복을 수행하는 반복기 함수 또는 Get 접근자에 포함됩니다.

For Each...Next 문 또는 LINQ 쿼리를 사용하여 반복기 함수를 사용합니다. For Each 반복의 각 반복은 반복기 함수를 호출합니다. 반복기 함수에서 Yield 문에 도달하면 expression이 반환되고 코드의 현재 위치가 유지됩니다. 다음에 반복기 함수가 호출되면 해당 위치에서 실행이 다시 시작됩니다.

암시적 변환은 Yield 문의 expression 형식에서 반복기의 반환 형식으로 존재해야 합니다.

Exit Function 또는 Return 문을 사용하여 반복을 종료할 수 있습니다.

"Yield"는 예약어가 아니며 Iterator 함수 또는 Get 접근자에서 사용되는 경우에만 특별한 의미를 가집니다.

반복기 함수 및 Get 접근자에 대한 자세한 내용은 반복기를 참조하세요.

반복기 함수 및 Get 접근자

반복기 함수 또는 Get 접근자의 선언은 다음 요구 사항을 충족해야 합니다.

• 반복기 한정자를 포함해야 합니다.

• 반환 형식은 IEnumerable, IEnumerable<T>, IEnumerator, 또는 IEnumerator<T>여야 합니다.

• ByRef 매개 변수를 가질 수 없습니다.

반복기 함수는 이벤트, 인스턴스 생성자, 정적 생성자 또는 정적 소멸자에서 발생할 수 없습니다.

반복기 함수는 익명 함수일 수 있습니다. 자세한 내용은 반복기를 참조하세요.

예외 처리

Yield 문은 Try...Catch...Finally 문의 Try 블록 내부에 있을 수 있습니다. Yield 문이 있는 Try 블록에는 Catch 블록이 있을 수 있으며 Finally 블록이 있을 수 있습니다.

Yield 문은 Catch 블록 또는 Finally 블록 내에 있을 수 없습니다.

반복기 함수 외부의 For Each 본문에서 예외가 throw되면 반복기 함수의 Catch 블록이 실행되지 않지만 반복기 함수의 Finally 블록이 실행됩니다. 반복기 함수 내의 Catch 블록은 반복기 함수 내에서 발생하는 예외만 catch합니다.

기술 구현

다음 코드는 반복기 함수에서 IEnumerable (Of String)을 반환한 다음 IEnumerable (Of String) 요소를 반복합니다.

Dim elements As IEnumerable(Of String) = MyIteratorFunction()  
    …  
For Each element As String In elements  
Next  

MyIteratorFunction 호출은 함수의 본문을 실행하지 않습니다. 대신에 IEnumerable(Of String) 변수에 elements을 반환합니다.

For Each 루프 반복에서 MoveNext에 대한 elements 메서드가 호출됩니다. 이 호출은 다음 MyIteratorFunction 문에 도달할 때까지 Yield 본문을 실행합니다. Yield 문은 반복 본문에서 사용할 element 변수의 값뿐만 아니라 요소의 Current 속성인 IEnumerable (Of String)도 결정하는 식을 반환합니다.

이후에 For Each 루프가 반복될 때마다 중지되었던 위치에서 반복기 본문 실행이 계속되고 Yield 문에 도달하면 다시 중지됩니다. 반복기 함수 또는 Return 또는 Exit Function 문의 끝에 도달하면 For Each 반복이 완료됩니다.

예 1

다음 예제에는 For…Next 반복 내부에 Yield 문이 있습니다. Main의 For Each 문 본문을 반복할 때마다 Power 반복기 함수에 대한 호출이 만들어집니다. 반복기 함수를 호출할 때마다 다음에 Yield 루프를 반복하는 도중에 For…Next 문이 실행됩니다.

반복기 메서드의 반환 형식은 반복기 인터페이스 형식인 IEnumerable<T>입니다. 반복기 메서드가 호출되면 숫자의 거듭제곱이 들어 있는 열거형 개체를 반환합니다.

Sub Main()
    For Each number In Power(2, 8)
        Console.Write(number & " ")
    Next
    ' Output: 2 4 8 16 32 64 128 256
    Console.ReadKey()
End Sub

Private Iterator Function Power(
ByVal base As Integer, ByVal highExponent As Integer) _
As System.Collections.Generic.IEnumerable(Of Integer)

    Dim result = 1

    For counter = 1 To highExponent
        result = result * base
        Yield result
    Next
End Function

예제 2

다음 예제는 반복기인 Get 접근자에 대해 설명합니다. 속성 선언에는 Iterator 한정자가 포함됩니다.

Sub Main()
    Dim theGalaxies As New Galaxies
    For Each theGalaxy In theGalaxies.NextGalaxy
        With theGalaxy
            Console.WriteLine(.Name & "  " & .MegaLightYears)
        End With
    Next
    Console.ReadKey()
End Sub

Public Class Galaxies
    Public ReadOnly Iterator Property NextGalaxy _
    As System.Collections.Generic.IEnumerable(Of Galaxy)
        Get
            Yield New Galaxy With {.Name = "Tadpole", .MegaLightYears = 400}
            Yield New Galaxy With {.Name = "Pinwheel", .MegaLightYears = 25}
            Yield New Galaxy With {.Name = "Milky Way", .MegaLightYears = 0}
            Yield New Galaxy With {.Name = "Andromeda", .MegaLightYears = 3}
        End Get
    End Property
End Class

Public Class Galaxy
    Public Property Name As String
    Public Property MegaLightYears As Integer
End Class

추가 예를 보려면 반복기를 참조하세요.

참고 항목

• 문