string.hxx

Go to the documentation of this file.

/*
 * Copyright (C) 2024-2026 David C. Manuelda (StormBytePP)
 *
 * This file is part of StormByte.
 *
 * StormByte is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License version 3
 * or later, as published by the Free Software Foundation.
 *
 * StormByte is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with StormByte. If not, see
 * <https://www.gnu.org/licenses/lgpl-3.0.html>.
 */
 
#pragma once
 
#include <StormByte/exception.hxx>
#include <StormByte/expected.hxx>
#include <StormByte/visibility.h>
 
#include <algorithm>
#include <cstddef>
#include <cmath>
#include <cctype>
#include <iomanip>
#include <locale>
#include <queue>
#include <sstream>
#include <string>
#include <string_view>
#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(std::string_view str) noexcept {
        return !str.empty() && std::all_of(str.begin(), str.end(), [](unsigned char c) {
            return std::isdigit(c) != 0;
        });
    }
 
    STORMBYTE_PUBLIC std::string ToLower(std::string_view str) noexcept;
 
    STORMBYTE_PUBLIC std::string ToUpper(std::string_view str) noexcept;
 
    STORMBYTE_PUBLIC std::queue<std::string> Explode(std::string_view str, const char delimiter);
 
    STORMBYTE_PUBLIC std::vector<std::string> Split(std::string_view str);
 
    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(std::wstring_view ws);
 
    STORMBYTE_PUBLIC std::wstring UTF8Decode(std::string_view s);
 
    STORMBYTE_PUBLIC std::string SanitizeNewlines(std::string_view str) noexcept;
 
    STORMBYTE_PUBLIC std::string FromByteVector(const std::vector<std::byte>& byte_vector) noexcept;
 
    STORMBYTE_PUBLIC std::vector<std::byte> ToByteVector(std::string_view str) noexcept;
 
    STORMBYTE_PUBLIC std::string RemoveWhitespace(std::string_view str) noexcept;
 
    STORMBYTE_PUBLIC bool IsInteger(std::string_view str) noexcept;
}