Array.sortBy<'T,'Key> Function (F#)

Article
2013-02-04

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 -> 'Key

The 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 7, Windows Vista SP2, Windows XP SP3, Windows XP x64 SP2, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Server 2003 SP2

Version Information

F# Runtime

Supported in: 2.0, 4.0

Silverlight

Supported in: 3

Share via