lib/src/util/support/string.ts

/**
 * If `string` is less than `length` characters long, add however many `padWith` characters
 * are necessary to make up the difference to the END of the string.
 * @param string
 * @param length
 * @param padWith
 */
export function padRight(string: string, length: number, padWith = ' '): string {
    while ( string.length < length ) {
        string += padWith
    }

    return string
}

/**
 * If `string` is less than `length` characters long, add however many `padWith` characters
 * are necessary to make up the difference to the BEGINNING of the string.
 * @param string
 * @param length
 * @param padWith
 */
export function padLeft(string: string, length: number, padWith = ' '): string {
    while ( string.length < length ) {
        string = `${padWith}${string}`
    }

    return string
}

/**
 * If `string` is less than `length` characters long, add however many `padWith` characters
 * are necessary to make up the difference evenly split between the beginning and end of the string.
 * @param string
 * @param length
 * @param padWith
 */
export function padCenter(string: string, length: number, padWith = ' '): string {
    const bit = false
    while ( string.length < length ) {
        if ( bit ) {
            string = `${padWith}${string}`
        } else {
            string += padWith
        }
    }

    return string
}