共用方式為

Seq.filter<'T> 函式 (F#)

  • 發行項

傳回新集合，其中僅包含原本集合中讓指定的述詞傳回 true 的集合項目。

**命名空間/模組路徑：**Microsoft.FSharp.Collections.Seq

組件：FSharp.Core (在 FSharp.Core.dll 中)

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

// Usage:
Seq.filter predicate source

參數

  • predicate
    型別：'T ->bool

    用以測試輸入序列中的每個項目是否都應該包含在輸出中的函式。

  • source
    型別：seq<'T>

    輸入序列。

例外狀況

例外狀況

條件

ArgumentNullException

當輸入序列為 null 時擲回。

傳回值

結果序列。

備註

傳回的序列可以在執行緒之間安全地傳送。但是，您不應該並行存取傳回之序列產生的個別 IEnumerator 值。序列會延遲到必要時再評估。因此效果會延至列舉之後才會生效。

這個函式在已編譯的組件中名為 Filter。如果您是透過 F# 以外的語言，或是透過反映來存取函式，請使用這個名稱。

範例

下列程式碼顯示如何使用 Seq.filter 篩選亂數無限序列，以僅選取偶數。

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 ""

範例輸出

平台

Windows 8 中， Windows 7， Windows Server 2012 上， Windows Server 2008 R2

版本資訊

F# 核心程式庫版本

支援版本:2.0， 4.0，可攜式執行檔 (PE)。

請參閱

參考

Collections.Seq 模組 (F#)

Microsoft.FSharp.Collections 命名空間 (F#)