sortBy | /collections/sort_by.ts | std@0.116.0

function sortBy

import { sortBy } from "https://dotland.deno.dev/std@0.116.0/collections/sort_by.ts";

sortBy<T>(array: readonly T[], selector: ((el: T) => number)): T[]

Returns all elements in the given collection, sorted stably by their result using the given selector. The selector function is called only once for each element.

sortBy<T>(array: readonly T[], selector: ((el: T) => string)): T[]

sortBy<T>(array: readonly T[], selector: ((el: T) => bigint)): T[]

sortBy<T>(array: readonly T[], selector: ((el: T) => Date)): T[]

sortBy<T>(array: readonly T[], selector:

| ((el: T) => number)

| ((el: T) => string)

| ((el: T) => bigint)

| ((el: T) => Date)

): T[]

Returns all elements in the given collection, sorted stably by their result using the given selector. The selector function is called only once for each element.

Example:

import { sortBy } from "https://deno.land/std@0.116.0/collections/mod.ts"
import { assertEquals } from "https://deno.land/std@0.116.0/testing/asserts.ts";

const people = [
    { name: 'Anna', age: 34 },
    { name: 'Kim', age: 42 },
    { name: 'John', age: 23 },
]
const sortedByAge = sortBy(people, it => it.age)

assertEquals(sortedByAge, [
    { name: 'John', age: 23 },
    { name: 'Anna', age: 34 },
    { name: 'Kim', age: 42 },
])

| ((el: T) => bigint)

| ((el: T) => Date)

Returns

T[]