string.hxx

#pragma once
 
#include <StormByte/buffer/simple.hxx>
 
#include <algorithm>
#include <cstdint>
#include <cmath>
#include <iomanip>
#include <locale>
#include <queue>
#include <sstream>
#include <string>
#include <utility>
#include <vector>
 
namespace StormByte::String {
    enum class STORMBYTE_PUBLIC Format : unsigned short {
        Raw,                        
        HumanReadableNumber,        
        HumanReadableBytes          
    };
 
    constexpr STORMBYTE_PUBLIC std::string Indent(const int& level) noexcept {
        return level == 0 ? std::string() : std::string(level, '\t');
    }
 
    constexpr STORMBYTE_PUBLIC bool IsNumeric(const std::string& str) noexcept {
        return !str.empty() && std::all_of(str.begin(), str.end(), ::isdigit);
    }
 
    STORMBYTE_PUBLIC std::string ToLower(const std::string& str) noexcept;
 
    STORMBYTE_PUBLIC std::string ToUpper(const std::string& str) noexcept;
 
    STORMBYTE_PUBLIC std::queue<std::string> Explode(const std::string& str, const char delimiter);
 
    STORMBYTE_PUBLIC std::vector<std::string> Split(const std::string& str);
 
    STORMBYTE_PUBLIC StormByte::Expected<std::pair<int, int>, Exception> SplitFraction(const std::string& fraction);
 
    STORMBYTE_PUBLIC StormByte::Expected<std::pair<int, int>, Exception> SplitFraction(const std::string& str, const int& denominator);
 
    template <typename T, typename = std::enable_if_t<std::is_arithmetic_v<T> && !std::is_same_v<T, wchar_t>>>
    STORMBYTE_PUBLIC std::string HumanReadable(const T& number, const Format& format, const std::string& locale = "en_US.UTF-8") noexcept;
 
    STORMBYTE_PUBLIC std::string UTF8Encode(const std::wstring& ws);
 
    STORMBYTE_PUBLIC std::wstring UTF8Decode(const std::string& s);
 
    STORMBYTE_PUBLIC std::string SanitizeNewlines(const std::string& str) noexcept;
 
    STORMBYTE_PUBLIC std::string FromBuffer(const Buffer::Simple& buffer) noexcept;
 
    STORMBYTE_PUBLIC std::string FromBuffer(const Buffer::Data& data) noexcept;
 
    STORMBYTE_PUBLIC std::string FromBuffer(const std::span<const std::byte>& span) noexcept;
}