@hgargg-0710/one/dist/src/string/string.js

A tiny npm library purposed for providing beautiful solutions to frequent miniature (one-line/one-expression) tasks for various JS datatypes.

import { last, uniqueArr } from "../array/array.js";
/**
 * Returns a new string based off `x`, in which the first character is put through `.toUpperCase()`,
 * and the remainder are put through `.toLowerCase()`
 *
 * If `x` is empty, returns empty string
 */
export const capitalize = (x = "") => x.length ? `${x[0].toUpperCase()}${x.slice(1).toLowerCase()}` : "";
/**
 * Splits the string using `toExtract`, then joins it using `toReplaceWith`.
 *
 * `toReplaceWith` defaults to `""`
 */
export const extract = (string, toExtract, toReplaceWith = "") => string.split(toExtract).join(toReplaceWith);
/**
 * Counts the number of (non-intersecting) occurences of `substring` inside `string`
 */
export const count = (string, substring) => string.split(substring).length - 1;
/**
 * Creates a function for limiting the `string` with `maxlength` length,
 * and (if the `.length` exceeds the `maxlength`), replacing the end with
 * the `limitor`
 */
export const limit = (maxlength, limitor = "") => (string = "") => `${string.slice(0, Math.min(string.length, maxlength))}${string.length > maxlength ? limitor : ""}`;
/**
 * Returns the entirety of the string, except for the last symbol
 */
export const lastOut = (x) => x.slice(0, lastIndex(x));
/**
 * Concatenates the `strings`, and returns the result
 */
export const concat = (...strings) => strings.reduce((last, curr) => last + curr, "");
/**
 * Performs an algorithm of "covering" on the given strings, and returns the result.
 *
 * Covering on two strings `a, b` returns `a + b.slice(a.length)`,
 * that is, replacing the first `a.length` characters of `b` with `a`,
 * and concatenating the remainder.
 */
export const cover = (...strings) => strings.reduce((covering, covered) => `${covering}${covered.slice(covering.length)}`, "");
/**
 * A function returning whether the given string is empty.
 */
export const isEmpty = (x) => !x.length;
/**
 * Returns the last index of a given string
 */
export const lastIndex = (x) => x.length - 1;
/**
 * Returns `x.charCodeAt(i)`. `i` defaults to 0
 */
export const charCodeAt = (x, i = 0) => x.charCodeAt(i);
/**
 * Consequently splits the given string `x` using `splitBy` delimiters, and returns the result.
 */
export const multiSplit = (x, splitBy) => {
    let orig = x;
    splitBy = uniqueArr(splitBy);
    const finalDelim = last(splitBy);
    for (let i = 0; i < splitBy.length - 1; ++i)
        orig = extract(orig, splitBy[i], finalDelim);
    return orig.split(finalDelim);
};