bitburner-src/utils/StringHelperFunctions.ts

import { dialogBoxCreate } from "./DialogBox.js";

// Netburner String helper functions

// Replaces the character at an index with a new character
function replaceAt(base: string, index: number, character: string): string {
    return base.substr(0, index) + character + base.substr(index + character.length);
}

/*
Converts a date representing time in milliseconds to a string with the format H hours M minutes and S seconds
e.g.    10000 -> "0 hours 0 minutes and 10 seconds"
        120000 -> "0 0 hours 2 minutes and 0 seconds"
*/
function convertTimeMsToTimeElapsedString(time: number): string {
    const millisecondsPerSecond = 1000;
    const secondPerMinute = 60;
    const minutesPerHours = 60;
    const secondPerHours: number = secondPerMinute * minutesPerHours;
    const hoursPerDays = 24;
    const secondPerDay: number = secondPerHours * hoursPerDays;

    // Convert ms to seconds, since we only have second-level precision
    const totalSeconds: number = Math.floor(time / millisecondsPerSecond);

    const days: number = Math.floor(totalSeconds / secondPerDay);
    const secTruncDays: number = totalSeconds % secondPerDay;

    const hours: number = Math.floor(secTruncDays / secondPerHours);
    const secTruncHours: number = secTruncDays % secondPerHours;

    const minutes: number = Math.floor(secTruncHours / secondPerMinute);
    const secTruncMinutes: number = secTruncHours % secondPerMinute;

    const seconds: number = secTruncMinutes;

    let res = "";
    if (days) {res += `${days} days `; }
    if (hours) {res += `${hours} hours `; }
    if (minutes) {res += `${minutes} minutes `; }
    res += `${seconds} seconds `;

    return res;
}

// Finds the longest common starting substring in a set of strings
function longestCommonStart(strings: string[]): string {
    if (!containsAllStrings(strings)) {return ""; }
    if (strings.length == 0) {return ""; }

    const A: string[] = strings.concat().sort();
    const a1: string = A[0];
    const a2: string = A[A.length - 1];
    const L: number = a1.length;
    let i = 0;
    while (i < L && a1.charAt(i).toLowerCase() === a2.charAt(i).toLowerCase()) { i++; }

    return a1.substring(0, i);
}

// Returns whether a variable is a string
function isString(str: any): boolean {
    return (typeof str === "string" || str instanceof String);
}

// Returns whether an array contains entirely of string objects
function containsAllStrings(arr: string[]): boolean {
    return arr.every(isString);
}

// Formats a number with commas and a specific number of decimal digits
function formatNumber(num: number, numFractionDigits: number): string {
    return num.toLocaleString(undefined, {
        maximumFractionDigits: numFractionDigits,
        minimumFractionDigits: numFractionDigits,
    });
}

// Count the number of times a substring occurs in a string
function numOccurrences(text: string, subString: string): number {
    text += "";
    subString += "";
    if (subString.length <= 0) { return (text.length + 1); }

    let n = 0;
    let pos = 0;
    const step: number = subString.length;

    while (true) {
        pos = text.indexOf(subString, pos);
        if (pos >= 0) {
            ++n;
            pos += step;
        } else { break; }
    }

    return n;
}

// Counters the number of Netscript operators in a string
function numNetscriptOperators(text: string): number {
    const total: number = numOccurrences(text, "+") +
        numOccurrences(text, "-") +
        numOccurrences(text, "*") +
        numOccurrences(text, "/") +
        numOccurrences(text, "%") +
        numOccurrences(text, "&&") +
        numOccurrences(text, "||") +
        numOccurrences(text, "<") +
        numOccurrences(text, ">") +
        numOccurrences(text, "<=") +
        numOccurrences(text, ">=") +
        numOccurrences(text, "==") +
        numOccurrences(text, "!=");
    if (isNaN(total)) {
        const message = "ERROR in counting number of operators in script. This is a bug, please report to game developer";
        dialogBoxCreate(message, false);

        return 0;
    }

    return total;
}

// Checks if a string contains HTML elements
function isHTML(str: string): boolean {
    const a = document.createElement("div");
    a.innerHTML = str;
    const c = a.childNodes;
    for (let i = c.length; i--;) {
        if (c[i].nodeType == 1) { return true; }
    }

    return false;
}

// Generates a random alphanumeric string with N characters
function generateRandomString(n: number): string {
    let str = "";
    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";

    for (let i = 0; i < n; i++) {
        str += chars.charAt(Math.floor(Math.random() * chars.length));
    }

    return str;
}

export {convertTimeMsToTimeElapsedString, longestCommonStart,
        isString, containsAllStrings, formatNumber,
        numOccurrences, numNetscriptOperators, isHTML, generateRandomString, replaceAt};