Hyperlinkv0.8.0-beta.28

String

String.localeCompareconsteffect/String.ts:681
(that: string, locales?: Array<string>, options?: Intl.CollatorOptions): (
  self: string
) => Ordering.Ordering

Computes locale-aware ordering for two strings, with optional locales and collator options, and returns the result as an Ordering (-1, 0, or 1).

Example (Comparing strings by locale)

import { pipe, String } from "effect"
import * as assert from "node:assert"

assert.deepStrictEqual(pipe("a", String.localeCompare("b")), -1)
assert.deepStrictEqual(pipe("b", String.localeCompare("a")), 1)
assert.deepStrictEqual(pipe("a", String.localeCompare("a")), 0)
comparing
Source effect/String.ts:6813 lines
export const localeCompare =
  (that: string, locales?: Array<string>, options?: Intl.CollatorOptions) => (self: string): Ordering.Ordering =>
    number.sign(self.localeCompare(that, locales, options))