Seq.sortBy<'T,'Key> 函式 (F#)

將索引鍵產生函式套用至序列的每個項目，並產生依索引鍵排序的序列。索引鍵是使用 Operators.compare 所實作的泛型比較來比較。

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

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

// Signature:
Seq.sortBy : ('T -> 'Key) -> seq<'T> -> seq<'T> (requires comparison)

// Usage:
Seq.sortBy projection source

參數

• projection
  型別：'T -> 'Key

  函式，將輸入序列的項目轉換成可比較的索引鍵。

• source
  型別：seq<'T>

  輸入序列。

例外狀況

例外狀況	條件
ArgumentNullException	在輸入序列為 null 時擲回。

傳回值

結果序列。

備註

這個函式會傳回一個序列，這個序列會在逐一查看初始序列之後，立即摘要整個初始序列。因此，這個函式不應該搭配大型或無限序列使用。這個函式不會假設原本序列的排序方式。這是穩定排序，也就是會保留相等項目的原始順序。

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

平台

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

版本資訊

F# 核心程式庫版本

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

請參閱

參考

Collections.Seq 模組 (F#)

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