Array.sortBy<'T,'Key> Function (F#)
Sorts the elements of an array, using the given projection for the keys and returning a new array. Elements are compared using Operators.compare.
Namespace/Module Path: Microsoft.FSharp.Collections.Array
Assembly: FSharp.Core (in FSharp.Core.dll)
// Signature:
Array.sortBy : ('T -> 'Key) -> 'T [] -> 'T [] (requires comparison)
// Usage:
Array.sortBy projection array
Parameters
projection
Type: 'T -> 'KeyThe function to transform array elements into the type that is compared.
array
Type: 'T[]The input array.
Return Value
The sorted array.
Remarks
This is not a stable sort, that is, the original order of equal elements is not necessarily preserved. For a stable sort, consider using Seq.sort.
This function is named SortBy in compiled assemblies. If you are accessing the function from a language other than F#, or through reflection, use this name.
Example
The following code illustrates the use of Array.sortBy.
let sortedArray2 = Array.sortBy (fun elem -> abs elem) [|1; 4; 8; -2; 5|]
printfn "%A" sortedArray2
Output
[|1; -2; 4; 5; 8|]
Platforms
Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2
Version Information
F# Core Library Versions
Supported in: 2.0, 4.0, Portable