Seq.filter<'T>-Funktion (F#)

Aktualisiert: August 2010

Gibt eine neue Auflistung zurück, die nur die Elemente der Auflistung enthält, für die das angegebene Prädikat true zurückgibt.

Namespace/Modulpfad: Microsoft.FSharp.Collections.Seq

Assembly: FSharp.Core (in FSharp.Core.dll)

// Signature:
Seq.filter : ('T -> bool) -> seq<'T> -> seq<'T>

// Usage:
Seq.filter predicate source

Parameter

• predicate
  Typ: 'T -> bool

  Eine Funktion, die überprüft, ob jedes Element in der Eingabesequenz in die Ausgabe aufgenommen werden soll.

• source
  Typ: seq<'T>

  Die Eingabesequenz.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Wird ausgelöst, wenn die Eingabesequenz NULL ist.

Rückgabewert

Die Ergebnissequenz.

Hinweise

Die zurückgegebene Sequenz kann zwischen Threads sicher übergeben werden. Auf einzelne IEnumerator-Werte, die aus der zurückgegebenen Sequenz generiert werden, sollte nicht gleichzeitig zugegriffen werden. Die Sequenz wird verzögert ausgewertet. Deshalb werden Effekte bis zur Aufzählung verzögert.

Der Name dieser Funktion in kompilierten Assemblys lautet Filter. Verwenden Sie diesen Namen, wenn Sie in einer anderen .NET-Sprache als F# oder durch Reflektion auf die Funktion zugreifen.

Beispiel

Im folgenden Code wird veranschaulicht, wie mit Seq.filter eine unendliche Sequenz von zufälligen Zahlen so gefiltert wird, dass nur gerade Zahlen ausgewählt werden.

let random = new System.Random()
Seq.initInfinite (fun _ -> random.Next())
|> Seq.filter (fun x -> x % 2 = 0)
|> Seq.take 5
|> Seq.iter (fun elem -> printf "%d " elem)
printfn ""

Beispielausgabe

Plattformen

Windows 7, Windows Vista SP2, Windows XP SP3, Windows XP x64 SP2, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Server 2003 SP2

Versionsinformationen

F#-Runtime

Unterstützt in: 2.0, 4.0

Silverlight

Unterstützt in: 3

Siehe auch

Weitere Ressourcen

Collections.Seq-Modul (F#)

Microsoft.FSharp.Collections-Namespace (F#)

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
August 2010	Codebeispiel hinzugefügt.	Informationsergänzung.