Enumerable.TakeWhile Metoda

Definice

Obor názvů:

System.Linq

Sestavení:

netstandard.dll, System.Linq.dll

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

Přetížení

Name	Description
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 prvků .source

Parametry

source

IEnumerable<TSource>

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

predicate

Func<TSource,Int32,Boolean>

Funkce k otestování jednotlivých zdrojových prvků 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, ve kterém test již 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í prvků ze začátku sekvence, pokud podmínka, která používá index elementu je 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
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čte buď voláním metody GetEnumerator přímo nebo pomocí foreach v jazyce C# nebo For Each v Visual Basic.

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

První argument predicate představuje prvek, který se má testovat. Druhý argument představuje index založený na nule prvku uvnitř 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 syntaxi výrazu dotazu Visual Basic se klauzule Take While přeloží na vyvolání 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 prvků .source

Parametry

source

IEnumerable<TSource>

Posloupnost 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

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

Metoda TakeWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) testuje každý prvek source pomocí a predicate dává prvek, pokud je truevýsledek . Výčet se zastaví, když predikát funkce vrátí false 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 syntaxi výrazu dotazu Visual Basic se klauzule Take While přeloží na vyvolání TakeWhile.

Viz také

• Take While – klauzule (Visual Basic)