Enumerable.TakeWhile Enumerable.TakeWhile Enumerable.TakeWhile Enumerable.TakeWhile Method

정의

지정된 된 조건이 true 이면 있고 다음 나머지 요소를 건너뜁니다 시퀀스에서 요소를 반환 합니다.Returns elements from a sequence as long as a specified condition is true, and then skips the remaining elements.

오버로드

TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

으로 지정 된 조건이 true 인 시퀀스에서 요소를 반환 합니다.Returns elements from a sequence as long as a specified condition is true.

TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)

으로 지정 된 조건이 true 인 시퀀스에서 요소를 반환 합니다.Returns elements from a sequence as long as a specified condition is true. 조건자 함수의 논리에 요소의 인덱스가 사용됩니다.The element's index is used in the logic of the predicate function.

TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

으로 지정 된 조건이 true 인 시퀀스에서 요소를 반환 합니다.Returns elements from a sequence as long as a specified condition is true.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ TakeWhile(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);
public static System.Collections.Generic.IEnumerable<TSource> TakeWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);
static member TakeWhile : seq<'Source> * Func<'Source, bool> -> seq<'Source>
<Extension()>
Public Function TakeWhile(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As IEnumerable(Of TSource)

형식 매개 변수

TSource

source 요소의 형식입니다.The type of the elements of source.

매개 변수

source
IEnumerable<TSource>

요소를 반환할 시퀀스입니다.A sequence to return elements from.

predicate
Func<TSource,Boolean>

각 요소를 조건에 대해 테스트하는 함수입니다.A function to test each element for a condition.

반환

IEnumerable<TSource>

IEnumerable<T> 는 테스트가 더 이상 통과 하기 전에 발생 하는 입력된 시퀀스에서 요소를 포함 하는 합니다.An IEnumerable<T> that contains the elements from the input sequence that occur before the element at which the test no longer passes.

예외

source 또는 predicatenull인 경우source or predicate is null.

예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다. TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) 으로 조건이 true 인 시퀀스의 시작 부분에서 요소를 반환 합니다.The following code example demonstrates how to use TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) to return elements from the start of a sequence as long as a condition is true.

string[] fruits = { "apple", "banana", "mango", "orange", 
                      "passionfruit", "grape" };

IEnumerable<string> query =
    fruits.TakeWhile(fruit => String.Compare("orange", fruit, true) != 0);

foreach (string fruit in query)
{
    Console.WriteLine(fruit);
}

/*
 This code produces the following output:

 apple
 banana
 mango
*/
' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Take strings from the array until one of
' the strings matches "orange".
Dim query As IEnumerable(Of String) =
fruits.TakeWhile(Function(fruit) _
                     String.Compare("orange", fruit, True) <> 0)

' Display the results.
Dim output As New System.Text.StringBuilder
For Each fruit As String In query
    output.AppendLine(fruit)
Next
MsgBox(output.ToString())

' This code produces the following output:
'
' apple
' banana
' mango

설명

이 메서드는 지연 된 실행을 사용 하 여 구현 됩니다.This method is implemented by using deferred execution. 즉시 반환 값은 작업을 수행 하는 데 필요한 모든 정보를 저장 하는 개체입니다.The immediate return value is an object that stores all the information that is required to perform the action. 이 메서드를 나타내는 쿼리 하거나 호출 하 여 개체 열거 될 때까지 실행 되지 않습니다 해당 GetEnumerator 메서드를 사용 하 여 직접 또는 foreach Visual C# 또는 For Each Visual Basic의 합니다.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

합니다 TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) 의 각 요소를 테스트 하는 메서드 source 를 사용 하 여 predicate 결과가 요소를 생성 하 고 true입니다.The TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method tests each element of source by using predicate and yields the element if the result is true. 조건자 함수는 반환 될 때 열거형 중지 false 요소에 대 한 때나 source 요소가 더 이상 포함 되어 있습니다.Enumeration stops when the predicate function returns false for an element or when source contains no more elements.

합니다 TakeWhileSkipWhile 방법이 기능 보완 합니다.The TakeWhile and SkipWhile methods are functional complements. 지정 된 순서 coll 순수 함수 p의 결과 연결 coll.TakeWhile(p) 하 고 coll.SkipWhile(p) 과 동일한 시퀀스가 coll.Given a sequence coll and a pure function p, concatenating the results of coll.TakeWhile(p) and coll.SkipWhile(p) yields the same sequence as coll.

Visual Basic 쿼리 식 구문에는 Take While 절 뒤에 변환 TakeWhile합니다.In Visual Basic query expression syntax, a Take While clause translates to an invocation of TakeWhile.

추가 정보

TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)

으로 지정 된 조건이 true 인 시퀀스에서 요소를 반환 합니다.Returns elements from a sequence as long as a specified condition is true. 조건자 함수의 논리에 요소의 인덱스가 사용됩니다.The element's index is used in the logic of the predicate function.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ TakeWhile(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int, bool> ^ predicate);
public static System.Collections.Generic.IEnumerable<TSource> TakeWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,bool> predicate);
static member TakeWhile : seq<'Source> * Func<'Source, int, bool> -> seq<'Source>
<Extension()>
Public Function TakeWhile(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Integer, Boolean)) As IEnumerable(Of TSource)

형식 매개 변수

TSource

source 요소의 형식입니다.The type of the elements of source.

매개 변수

source
IEnumerable<TSource>

요소가 반환되는 시퀀스입니다.The sequence to return elements from.

predicate
Func<TSource,Int32,Boolean>

각 소스 요소를 조건에 대해 테스트할 함수이며, 이 함수의 두 번째 매개 변수는 소스 요소의 인덱스를 나타냅니다.A function to test each source element for a condition; the second parameter of the function represents the index of the source element.

반환

IEnumerable<TSource>

IEnumerable<T> 는 테스트가 더 이상 통과 하기 전에 발생 하는 입력된 시퀀스에서 요소를 포함 하는 합니다.An IEnumerable<T> that contains elements from the input sequence that occur before the element at which the test no longer passes.

예외

source 또는 predicatenull인 경우source or predicate is null.

예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다. TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) 으로 요소의 인덱스를 사용 하는 조건이 true 인 시퀀스의 시작 부분에서 요소를 반환 합니다.The following code example demonstrates how to use TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) to return elements from the start of a sequence as long as a condition that uses the element's index is true.

string[] fruits = { "apple", "passionfruit", "banana", "mango", 
                      "orange", "blueberry", "grape", "strawberry" };

IEnumerable<string> query =
    fruits.TakeWhile((fruit, index) => fruit.Length >= index);

foreach (string fruit in query)
{
    Console.WriteLine(fruit);
}

/*
 This code produces the following output:

 apple
 passionfruit
 banana
 mango
 orange
 blueberry
*/
' Create an array of strings.
Dim fruits() As String =
{"apple", "passionfruit", "banana", "mango",
 "orange", "blueberry", "grape", "strawberry"}

' Take strings from the array until one
' of the string's lengths is greater than or
' equal to the string item's index in the array.
Dim query As IEnumerable(Of String) =
fruits.TakeWhile(Function(fruit, index) _
                     fruit.Length >= index)

' Display the results.
Dim output As New System.Text.StringBuilder
For Each fruit As String In query
    output.AppendLine(fruit)
Next
MsgBox(output.ToString())

' This code produces the following output:
'
' apple
' passionfruit
' banana
' mango
' orange
' blueberry

설명

이 메서드는 지연 된 실행을 사용 하 여 구현 됩니다.This method is implemented by using deferred execution. 즉시 반환 값은 작업을 수행 하는 데 필요한 모든 정보를 저장 하는 개체입니다.The immediate return value is an object that stores all the information that is required to perform the action. 이 메서드를 나타내는 쿼리 하거나 호출 하 여 개체 열거 될 때까지 실행 되지 않습니다 해당 GetEnumerator 메서드를 사용 하 여 직접 또는 foreach Visual C# 또는 For Each Visual Basic의 합니다.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

합니다 TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) 의 각 요소를 테스트 하는 메서드 source 를 사용 하 여 predicate 결과가 요소를 생성 하 고 true입니다.The TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) method tests each element of source by using predicate and yields the element if the result is true. 조건자 함수는 반환 될 때 열거형 중지 false 요소에 대 한 때나 source 요소가 더 이상 포함 되어 있습니다.Enumeration stops when the predicate function returns false for an element or when source contains no more elements.

첫 번째 인수 predicate 테스트할 요소를 나타냅니다.The first argument of predicate represents the element to test. 두 번째 인수는 요소 내에서 0부터 시작 인덱스를 나타내는 source합니다.The second argument represents the zero-based index of the element within source.

합니다 TakeWhileSkipWhile 방법이 기능 보완 합니다.The TakeWhile and SkipWhile methods are functional complements. 지정 된 순서 coll 순수 함수 p의 결과 연결 coll.TakeWhile(p) 하 고 coll.SkipWhile(p) 과 동일한 시퀀스가 coll.Given a sequence coll and a pure function p, concatenating the results of coll.TakeWhile(p) and coll.SkipWhile(p) yields the same sequence as coll.

Visual Basic 쿼리 식 구문에는 Take While 절 뒤에 변환 TakeWhile합니다.In Visual Basic query expression syntax, a Take While clause translates to an invocation of TakeWhile.

추가 정보

적용 대상