string_util.hpp

/*
 * string_util.hpp -- string utilities
 *
 * Copyright (c) 2013-2019 David Demelier <markand@malikania.fr>
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
#ifndef IRCCD_STRING_UTIL_HPP
#define IRCCD_STRING_UTIL_HPP
 
#include "sysconfig.hpp"
 
#include <ctime>
#include <initializer_list>
#include <limits>
#include <optional>
#include <sstream>
#include <stdexcept>
#include <string>
#include <string_view>
#include <type_traits>
#include <unordered_map>
#include <vector>
 
namespace irccd {
 
namespace string_util {
 
// {{{ subst
 
enum class subst_flags : unsigned {
    date            = (1 << 0),      
    keywords        = (1 << 1),      
    env             = (1 << 2),      
    shell           = (1 << 3),      
    irc_attrs       = (1 << 4),      
    shell_attrs     = (1 << 5)       
};
 
inline auto operator^(subst_flags v1, subst_flags v2) noexcept -> subst_flags
{
    return static_cast<subst_flags>(static_cast<unsigned>(v1) ^ static_cast<unsigned>(v2));
}
 
inline auto operator&(subst_flags v1, subst_flags v2) noexcept -> subst_flags
{
    return static_cast<subst_flags>(static_cast<unsigned>(v1) & static_cast<unsigned>(v2));
}
 
inline auto operator|(subst_flags v1, subst_flags v2) noexcept -> subst_flags
{
    return static_cast<subst_flags>(static_cast<unsigned>(v1) | static_cast<unsigned>(v2));
}
 
inline auto operator~(subst_flags v) noexcept -> subst_flags
{
    return static_cast<subst_flags>(~static_cast<unsigned>(v));
}
 
inline auto operator|=(subst_flags& v1, subst_flags v2) noexcept -> subst_flags&
{
    return v1 = v1 | v2;
}
 
inline auto operator&=(subst_flags& v1, subst_flags v2) noexcept -> subst_flags&
{
    return v1 = v1 & v2;
}
 
inline auto operator^=(subst_flags& v1, subst_flags v2) noexcept -> subst_flags&
{
    return v1 = v1 ^ v2;
}
 
class subst {
public:
    subst_flags flags{
        subst_flags::date |
        subst_flags::keywords |
        subst_flags::env |
        subst_flags::irc_attrs
    };
 
    std::time_t time{std::time(nullptr)};
 
    std::unordered_map<std::string, std::string> keywords;
};
 
auto format(std::string text, const subst& params = {}) -> std::string;
 
// }}}
 
// {{{ strip
 
auto strip(std::string str) noexcept -> std::string;
 
// }}}
 
// {{{ split
 
auto split(std::string_view list, const std::string& delimiters, int max = -1) -> std::vector<std::string>;
 
// }}}
 
// {{{ join
 
template <typename InputIt, typename DelimType = char>
auto join(InputIt first, InputIt last, DelimType delim = ':') -> std::string
{
    std::ostringstream oss;
 
    if (first != last) {
        oss << *first;
 
        while (++first != last)
            oss << delim << *first;
    }
 
    return oss.str();
}
 
template <typename Container, typename DelimType = char>
auto join(const Container& c, DelimType delim = ':') -> std::string
{
    return join(c.begin(), c.end(), delim);
}
 
template <typename T, typename DelimType = char>
auto join(std::initializer_list<T> list, DelimType delim = ':') -> std::string
{
    return join(list.begin(), list.end(), delim);
}
 
// }}}
 
// {{{ is_identifier
 
auto is_identifier(std::string_view name) noexcept -> bool;
 
// }}}
 
// {{{ is_boolean
 
auto is_boolean(std::string value) noexcept -> bool;
 
// }}}
 
// {{{ to_int
 
template <typename T = int>
auto to_int(const std::string& str,
            T min = std::numeric_limits<T>::min(),
            T max = std::numeric_limits<T>::max()) noexcept -> std::optional<T>
{
    static_assert(std::is_signed<T>::value, "must be signed");
 
    char* end;
    auto v = std::strtoll(str.c_str(), &end, 10);
 
    if (*end != '\0' || v < min || v > max)
        return std::nullopt;
 
    return static_cast<T>(v);
}
 
// }}}
 
// {{{ to_uint
 
template <typename T = unsigned>
auto to_uint(const std::string& str,
             T min = std::numeric_limits<T>::min(),
             T max = std::numeric_limits<T>::max()) noexcept -> std::optional<T>
{
    static_assert(std::is_unsigned<T>::value, "must be unsigned");
 
    char* end;
    auto v = std::strtoull(str.c_str(), &end, 10);
 
    if (*end != '\0' || v < min || v > max)
        return std::nullopt;
 
    return static_cast<T>(v);
}
 
// }}}
 
} // !string_util
 
} // !irccd
 
#endif // !IRCCD_STRING_UTIL_HPP