Enumerable.TakeWhile Metoda

Definice

Obor názvů:

System.Linq

Sestavení:

System.Linq.dll

Vrátí elementy ze sekvence, pokud je zadaná podmínka pravdivá, a pak přeskočí zbývající prvky.

Přetížení

TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)	Vrátí prvky ze sekvence, pokud je zadaná podmínka pravdivá. Index elementu se používá v logice predikátové funkce.
TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Vrátí prvky ze sekvence, pokud je zadaná podmínka pravdivá.

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

Zdroj:

Take.cs

Vrátí prvky ze sekvence, pokud je zadaná podmínka pravdivá. Index elementu se používá v logice predikátové funkce.

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)

Parametry typu

TSource

Typ elementů .source

Parametry

source

IEnumerable<TSource>

Sekvence, ze které se mají vracet prvky.

predicate

Func<TSource,Int32,Boolean>

Funkce pro testování každého zdrojového prvku pro podmínku; druhý parametr funkce představuje index elementu source.

Návraty

IEnumerable<TSource>

Obsahuje IEnumerable<T> prvky ze vstupní sekvence, které se vyskytují před elementem, u kterého již test neprojde.

Výjimky

ArgumentNullException

source nebo predicate je null.

Příklady

Následující příklad kódu ukazuje, jak použít TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) k vrácení elementů od začátku sekvence, pokud podmínka, která používá index elementu, je pravdivá.

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
Console.WriteLine(output.ToString())

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

Poznámky

Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator metody přímo, nebo pomocí foreach v jazyce C# nebo For Each v jazyce Visual Basic.

Metoda TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) testuje každý prvek pomocí source a predicate poskytuje element, pokud je truevýsledek . Výčet se zastaví, když funkce predikátu vrátí false prvek nebo když source neobsahuje žádné další prvky.

První argument představuje predicate prvek, který se má testovat. Druhý argument představuje nulový index elementu v rámci source.

Metody TakeWhile a SkipWhile jsou funkční doplňky. Vzhledem k posloupnosti coll kolekce a čisté funkci pse zřetězení výsledků coll.TakeWhile(p) a coll.SkipWhile(p) vytvoří stejnou sekvenci jako coll.

V syntaxi výrazu dotazu jazyka Visual Basic se Take While klauzule překládá na vyvolání výrazu TakeWhile.

Viz také

• Take While – klauzule (Visual Basic)

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

Zdroj:

Take.cs

Vrátí prvky ze sekvence, pokud je zadaná podmínka pravdivá.

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)

Parametry typu

TSource

Typ elementů .source

Parametry

source

IEnumerable<TSource>

Sekvence, ze které se mají vrátit prvky.

predicate

Func<TSource,Boolean>

Funkce pro otestování každého prvku pro podmínku.

Návraty

IEnumerable<TSource>

Obsahuje IEnumerable<T> prvky ze vstupní sekvence, které se vyskytují před elementem, u kterého již test neprojde.

Výjimky

ArgumentNullException

source nebo predicate je null.

Příklady

Následující příklad kódu ukazuje, jak použít TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) k vrácení elementů od začátku sekvence, pokud je podmínka pravdivá.

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
Console.WriteLine(output.ToString())

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

Poznámky

Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator metody přímo, nebo pomocí foreach v jazyce C# nebo For Each v jazyce Visual Basic.

Metoda TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) testuje každý prvek pomocí source a predicate poskytuje element, pokud je truevýsledek . Výčet se zastaví, když funkce predikátu vrátí false prvek nebo když source neobsahuje žádné další prvky.

Metody TakeWhile a SkipWhile jsou funkční doplňky. Vzhledem k posloupnosti coll kolekce a čisté funkci pse zřetězení výsledků coll.TakeWhile(p) a coll.SkipWhile(p) vytvoří stejnou sekvenci jako coll.

V syntaxi výrazu dotazu jazyka Visual Basic se Take While klauzule překládá na vyvolání výrazu TakeWhile.

Viz také

• Take While – klauzule (Visual Basic)