StringHelper_V2.h

#pragma once

#include <cstddef>
#include <cstdint>
#include <list>
#include <string>
#include <vector>

class cStringHelper_V2
{
public:
    cStringHelper_V2() = delete;

    static void ThrowError(const char *error);

    static void newChar(unsigned char **buffer, std::size_t bufferSize);
    static void newChar(char **buffer, std::size_t bufferSize);

    static void delChar(unsigned char **buffer) noexcept;
    static void delChar(char **buffer) noexcept;

    static void HexToBin(
        char **src,
        std::size_t *srcSize,
        char **dest,
        std::size_t *destSize,
        bool delSrc = false);

    static void BinToHex(
        char **src,
        std::size_t *srcSize,
        char **dest,
        std::size_t *destSize,
        bool delSrc = false);

    [[nodiscard]] static std::string BufferToString(const char *src, std::size_t max);
    [[nodiscard]] static std::string IntToHex(std::uint64_t src, std::size_t minLen = 0u);
    [[nodiscard]] static std::string LongToString(long src, int base = 10);
    [[nodiscard]] static std::string LongToString(
        long src,
        int base,
        std::size_t minLength,
        char pad,
        bool prefix);
    [[nodiscard]] static std::string Int64ToString(std::int64_t src, int base = 10);

    [[nodiscard]] static long StrToInt32(std::string source, unsigned short sourceBase);
    [[nodiscard]] static std::int64_t StrToInt64(std::string source, unsigned short sourceBase);

    static void copyString(char *dest, const char *src, std::size_t max);
    static void copyString(char *dest, std::size_t max, const char *src, std::size_t srcLength);
    static void appendString(char *dest, const char *src, std::size_t max);

    [[nodiscard]] static bool checkBinary(
        std::size_t firstSize,
        const char *first,
        std::size_t secondSize,
        const char *second) noexcept;

    [[nodiscard]] static bool compareBinary(
        std::size_t firstSize,
        const char *first,
        std::size_t secondSize,
        const char *second) noexcept;

    [[nodiscard]] static bool findBinary(
        std::size_t stringSize,
        const char *stringData,
        std::size_t searchSize,
        const char *searchData,
        std::size_t *pos) noexcept;

    [[nodiscard]] static bool getBinaryBetween(
        const char *src,
        std::size_t srcSize,
        const char *start,
        std::size_t startSize,
        unsigned char startCount,
        const char *end,
        std::size_t endSize,
        unsigned char endCount,
        char *dest,
        std::size_t destCapacity,
        std::size_t *destSize);

    [[nodiscard]] static bool getStringBetween(
        const char *src,
        std::size_t srcSize,
        const std::string &start,
        unsigned char startCount,
        const std::string &end,
        unsigned char endCount,
        std::string *dest,
        const std::string &final = "");

    [[nodiscard]] static std::size_t getStringCount(
        const char *src,
        std::size_t srcSize,
        const std::string &search);

    [[nodiscard]] static bool splitString(
        const char *src,
        std::size_t srcSize,
        const std::string &delimiter,
        std::list<std::string> *dest,
        bool includeEmpty = true,
        const std::string &final = "");

    [[nodiscard]] static bool splitString(
        const char *src,
        std::size_t srcSize,
        std::list<std::string> *dest,
        char delimiter = ',',
        char qualifier = '"',
        bool includeEmpty = true);

    [[nodiscard]] static bool checkLeading(const std::string &source, const std::string &search) noexcept;
    [[nodiscard]] static bool checkMiddle(const std::string &source, const std::string &search) noexcept;
    [[nodiscard]] static bool checkTrailing(const std::string &source, const std::string &search) noexcept;
    [[nodiscard]] static bool checkFixedLength(std::size_t source, std::size_t check) noexcept;

    [[nodiscard]] static bool checkPatternCI(const char *source, const char *search);
    [[nodiscard]] static bool checkPattern(const char *source, const char *search);
    [[nodiscard]] static bool checkPattern(const char *source, std::size_t sourceSize, const char *search);

    [[nodiscard]] static bool checkPatternList(
        const char *source,
        const char *list,
        const char *delimiters = ",;");

    [[nodiscard]] static bool checkPatternListLen(
        const char *source,
        const char *list,
        std::size_t minLen = 1u,
        const char *delimiters = ",;");

    static void trim(std::string &source);
    [[nodiscard]] static std::string replaceAll(
        const std::string &source,
        const std::string &find,
        const std::string &replace);
    [[nodiscard]] static std::string replaceLeading(
        const std::string &source,
        const std::string &find,
        const std::string &replace);
    [[nodiscard]] static std::string replaceMiddle(
        const std::string &source,
        const std::string &find,
        const std::string &replace);
    [[nodiscard]] static std::string replaceTrailing(
        const std::string &source,
        const std::string &find,
        const std::string &replace);

    [[nodiscard]] static long compareStringNoCase(
        const std::string &string1,
        const std::string &string2) noexcept;

    [[nodiscard]] static std::string doEncrypt(const std::string &orig);
    [[nodiscard]] static std::string doDecrypt(const std::string &orig);
    [[nodiscard]] static std::string padToString(
        const std::string &source,
        std::size_t maxSize,
        char pad,
        bool prefix);

    static void split(const std::string &toSplit, char delim, std::vector<std::string> &results);
};