matchOrElse

function String.matchOrElse<T>(
    target: string,
    source: string | RegExp,
    orElse: (target: string) => T,
): RegExpMatchArray | T

Returns the result of matching target string against source string or regular expression, or the result of calling orElse function with target if no match is found.

Example

data-first

import { String } from "@monstermann/string";

String.matchOrElse("hello world", "world", () => []); // ["world", index: 6, input: "hello world", groups: undefined]
String.matchOrElse("hello world", /\d+/, (str) => [str]); // ["hello world"]

data-last

import { String } from "@monstermann/string";

pipe(
    "hello world",
    String.matchOrElse("world", () => []),
); // ["world", index: 6, input: "hello world", groups: undefined]

pipe(
    "hello world",
    String.matchOrElse(/\d+/, (str) => [str]),
); // ["hello world"]