stringhelpers.h

Go to the documentation of this file.

 
#ifndef STRINGHELPERS_H
#define STRINGHELPERS_H
 
#include <cstddef>
#include <cstdint>
#include <string>
#include <type_traits>
#include <vector>
 
namespace Nickvision::Helpers::StringHelpers
{
    template<typename T>
    concept StringImplicitlyConstructible = std::is_constructible_v<T, std::string> && std::is_convertible_v<std::string, T>;

    std::vector<std::byte> decode(const std::string& base64) noexcept;
    std::string encode(const std::vector<std::byte>& bytes) noexcept;
    bool isValidUrl(const std::string& s) noexcept;
    std::string join(const std::vector<std::string>& values, const std::string& separator, bool separateLast = false) noexcept;
    std::string lower(std::string s) noexcept;
    std::string newUuid() noexcept;
    std::string newGuid() noexcept;
    std::string normalizeForFilename(const std::string& s, bool windowsOnly = false) noexcept;
    std::string quote(const std::string& s) noexcept;
    std::string replace(std::string s, const std::string& toReplace, const std::string& replace) noexcept;
    std::string replace(std::string s, char toReplace, char replace) noexcept;
    std::vector<std::string> splitArgs(std::string s) noexcept;
    std::string str(const std::wstring& s) noexcept;
    unsigned int stoui(const std::string& s, size_t* idx = nullptr, int base = 10) noexcept;
    std::string trim(const std::string& s) noexcept;
    std::string trim(const std::string& s, char delimiter) noexcept;
    std::string upper(std::string s) noexcept;
    std::wstring wstr(const std::string& s) noexcept;
    template<StringImplicitlyConstructible T = std::string>
    std::vector<T> split(const std::string& s, const std::string& delimiter, bool includeEmpty = true) noexcept
    {
        std::vector<T> splits;
        size_t last{ 0 };
        size_t next{ 0 };
        while((next = s.find(delimiter, last)) != std::string::npos)
        {
            std::string token{ s.substr(last, next - last) };
            if(includeEmpty || !trim(token).empty())
            {
                splits.push_back(token);
            }
            last = next + delimiter.length();
 
        }
        std::string finalToken{ s.substr(last) };
        if(includeEmpty || !trim(finalToken).empty())
        {
            splits.push_back(finalToken);
        }
        return splits;
    }

    template<StringImplicitlyConstructible T = std::string>
    std::vector<T> split(const std::string& s, char delimiter, bool includeEmpty = true) noexcept
    {
        return split<T>(s, std::string(1, delimiter), includeEmpty);
    }
}
 
#endif // STRINGHELPERS_H