Enumerable.TakeWhile Metoda

Definice

Vrátí prvky 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 z posloupnosti, pokud je zadaná podmínka pravdivá. Index prvku se používá v logice predikátové funkce.

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

Vrátí prvky z posloupnosti, pokud je zadaná podmínka pravdivá.

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

Vrátí prvky z posloupnosti, pokud je zadaná podmínka pravdivá. Index prvku 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 prvků .source

Parametry

source
IEnumerable<TSource>

Sekvence pro vrácení prvků z.

predicate
Func<TSource,Int32,Boolean>

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

Návraty

IEnumerable<TSource>

Prvek IEnumerable<T> , který obsahuje prvky ze vstupní sekvence, ke které dochází před prvkem, u kterého už test neprojde.

Výjimky

source nebo predicate je null.

Příklady

Následující příklad kódu ukazuje, jak použít k vrácení elementů od začátku sekvence, pokud podmínka, která používá TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) 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 se nespustí, dokud objekt nevyčítá buď voláním metody GetEnumerator přímo, nebo pomocí foreach v jazyce Visual C# nebo For Each v Visual Basic.

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

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

Metody TakeWhile jsou SkipWhile funkční doplňky. Vzhledem k posloupnosti coll kolekce a čisté funkci pzřetězení výsledků coll.TakeWhile(p) a coll.SkipWhile(p) výnosu stejné sekvence jako coll.

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

Viz také

Platí pro

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

Vrátí prvky z posloupnosti, 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 prvků .source

Parametry

source
IEnumerable<TSource>

Sekvence pro vrácení prvků z.

predicate
Func<TSource,Boolean>

Funkce k otestování jednotlivých prvků pro podmínku

Návraty

IEnumerable<TSource>

Obsahuje IEnumerable<T> prvky ze vstupní sekvence, ke které dochází před prvkem, u kterého test již neprojde.

Výjimky

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 podmínka je 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 se nespustí, dokud objekt nevyčítá buď voláním metody GetEnumerator přímo, nebo pomocí foreach v jazyce Visual C# nebo For Each v Visual Basic.

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

Metody TakeWhile jsou SkipWhile funkční doplňky. Vzhledem k posloupnosti coll kolekce a čisté funkci pzřetězení výsledků coll.TakeWhile(p) a coll.SkipWhile(p) výnosu stejné sekvence jako coll.

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

Viz také

Platí pro