Enumerable.SkipWhile Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.
Sobrecargas
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) |
Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes. |
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) |
Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes. El índice del elemento se usa en la lógica de la función de predicado. |
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)
- Source:
- Skip.cs
- Source:
- Skip.cs
- Source:
- Skip.cs
Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TSource> ^ SkipWhile(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);
public static System.Collections.Generic.IEnumerable<TSource> SkipWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);
static member SkipWhile : seq<'Source> * Func<'Source, bool> -> seq<'Source>
<Extension()>
Public Function SkipWhile(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As IEnumerable(Of TSource)
Parámetros de tipo
- TSource
Tipo de los elementos de source
.
Parámetros
- source
- IEnumerable<TSource>
IEnumerable<T> del que se van a devolver los elementos.
Devoluciones
IEnumerable<T> que contiene los elementos de la secuencia de entrada comenzando por el primer elemento de la serie lineal que no pasa la prueba especificada en predicate
.
Excepciones
source
o predicate
es null
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) para omitir elementos de una matriz siempre y cuando se cumpla una condición.
int[] grades = { 59, 82, 70, 56, 92, 98, 85 };
IEnumerable<int> lowerGrades =
grades
.OrderByDescending(grade => grade)
.SkipWhile(grade => grade >= 80);
Console.WriteLine("All grades below 80:");
foreach (int grade in lowerGrades)
{
Console.WriteLine(grade);
}
/*
This code produces the following output:
All grades below 80:
70
59
56
*/
' Create an array of integers that represent grades.
Dim grades() As Integer = {59, 82, 70, 56, 92, 98, 85}
' Sort the grades in descending order and
' get all grades greater less than 80.
Dim lowerGrades As IEnumerable(Of Integer) =
grades _
.OrderByDescending(Function(grade) grade) _
.SkipWhile(Function(grade) grade >= 80)
' Display the results.
Dim output As New System.Text.StringBuilder("All grades below 80:" & vbCrLf)
For Each grade As Integer In lowerGrades
output.AppendLine(grade)
Next
Console.WriteLine(output.ToString())
' This code produces the following output:
'
' All grades below 80:
' 70
' 59
' 56
Comentarios
El SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su GetEnumerator
método o mediante foreach
en C# o For Each
en Visual Basic.
Este método prueba cada elemento de source
mediante predicate
y omite el elemento si el resultado es true
. Después de que la función de predicado devuelva false
para un elemento , ese elemento y los elementos restantes de source
se producen y no hay más invocaciones de predicate
.
Si predicate
devuelve true
para todos los elementos de la secuencia, se devuelve un valor vacío IEnumerable<T> .
Los TakeWhile métodos y SkipWhile son complementarios funcionales. Dada una secuencia coll
de colección y una función p
pura, concatenando los resultados de coll.TakeWhile(p)
y coll.SkipWhile(p)
produce la misma secuencia que coll
.
En la sintaxis de la expresión de consulta de Visual Basic, una Skip While
cláusula se traduce en una invocación de SkipWhile.
Consulte también
Se aplica a
SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>)
- Source:
- Skip.cs
- Source:
- Skip.cs
- Source:
- Skip.cs
Omite los elementos de una secuencia en tanto que el valor de una condición especificada sea true y luego devuelve los elementos restantes. El índice del elemento se usa en la lógica de la función de predicado.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TSource> ^ SkipWhile(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int, bool> ^ predicate);
public static System.Collections.Generic.IEnumerable<TSource> SkipWhile<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,bool> predicate);
static member SkipWhile : seq<'Source> * Func<'Source, int, bool> -> seq<'Source>
<Extension()>
Public Function SkipWhile(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Integer, Boolean)) As IEnumerable(Of TSource)
Parámetros de tipo
- TSource
Tipo de los elementos de source
.
Parámetros
- source
- IEnumerable<TSource>
IEnumerable<T> del que se van a devolver los elementos.
Función que va a probar cada elemento de origen para determinar si satisface una condición; el segundo parámetro de la función representa el índice del elemento de origen.
Devoluciones
IEnumerable<T> que contiene los elementos de la secuencia de entrada comenzando por el primer elemento de la serie lineal que no pasa la prueba especificada en predicate
.
Excepciones
source
o predicate
es null
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) para omitir elementos de una matriz siempre que una condición que dependa del índice del elemento sea true.
int[] amounts = { 5000, 2500, 9000, 8000,
6500, 4000, 1500, 5500 };
IEnumerable<int> query =
amounts.SkipWhile((amount, index) => amount > index * 1000);
foreach (int amount in query)
{
Console.WriteLine(amount);
}
/*
This code produces the following output:
4000
1500
5500
*/
' Create an array of integers.
Dim amounts() As Integer =
{5000, 2500, 9000, 8000, 6500, 4000, 1500, 5500}
' Skip items in the array whose value is greater than
' the item's index times 1000; get the remaining items.
Dim query As IEnumerable(Of Integer) =
amounts.SkipWhile(Function(amount, index) _
amount > index * 1000)
' Output the results.
Dim output As New System.Text.StringBuilder
For Each amount As Integer In query
output.AppendLine(amount)
Next
Console.WriteLine(output.ToString())
' This code produces the following output:
'
' 4000
' 1500
' 5500
Comentarios
Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su GetEnumerator
método o mediante foreach
en C# o For Each
en Visual Basic.
El SkipWhile<TSource>(IEnumerable<TSource>, Func<TSource,Int32,Boolean>) método prueba cada elemento de source
mediante predicate
y omite el elemento si el resultado es true
. Después de que la función de predicado devuelva false
para un elemento , ese elemento y los elementos restantes de source
se producen y no hay más invocaciones de predicate
.
Si predicate
devuelve true
para todos los elementos de la secuencia, se devuelve un valor vacío IEnumerable<T> .
El primer argumento de predicate
representa el elemento que se va a probar. El segundo argumento representa el índice de base cero del elemento dentro de source
.
Los TakeWhile métodos y SkipWhile son complementarios funcionales. Dada una secuencia coll
de colección y una función p
pura, concatenando los resultados de coll.TakeWhile(p)
y coll.SkipWhile(p)
produce la misma secuencia que coll
.
En la sintaxis de la expresión de consulta de Visual Basic, una Skip While
cláusula se traduce en una invocación de SkipWhile.