mgutility_enum_name.hpp

/*
MIT License
 
Copyright (c) 2023 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef MGUTILITY_ENUM_NAME_HPP
#define MGUTILITY_ENUM_NAME_HPP
 
/*
MIT License
 
Copyright (c) 2024 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef MGUTILITY_REFLECTION_DETAIL_ENUM_NAME_IMPL_HPP
#define MGUTILITY_REFLECTION_DETAIL_ENUM_NAME_IMPL_HPP
 
// NOLINTNEXTLINE [unused-includes]
 
/*
MIT License
 
Copyright (c) 2024 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef DETAIL_ENUM_FOR_EACH_HPP
#define DETAIL_ENUM_FOR_EACH_HPP
 
/*
MIT License
 
Copyright (c) 2024 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef DETAIL_META_HPP
#define DETAIL_META_HPP
 
/*
MIT License
 
Copyright (c) 2024 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef MGUTILITY_COMMON_DEFINITIONS_HPP
#define MGUTILITY_COMMON_DEFINITIONS_HPP
 
#ifdef _MSC_VER
#ifndef MGUTILITY_CPLUSPLUS
#define MGUTILITY_CPLUSPLUS _MSVC_LANG
#endif
#else
#ifndef MGUTILITY_CPLUSPLUS
#define MGUTILITY_CPLUSPLUS __cplusplus
#endif
#endif
 
#if MGUTILITY_CPLUSPLUS == 201103L
#define MGUTILITY_CNSTXPR
#elif MGUTILITY_CPLUSPLUS > 201103L
#define MGUTILITY_CNSTXPR constexpr
#elif MGUTILITY_CPLUSPLUS < 201103L
#error "Standards older than C++11 is not supported!"
#endif
 
#if (MGUTILITY_CPLUSPLUS >= 201703L && !defined(__clang__)) ||                 \
    (defined(__clang__) && __clang_major__ > 11 &&                             \
     MGUTILITY_CPLUSPLUS >= 201703L)
#define MGUTILITY_CNSTXPR_CLANG_WA constexpr
#else
#define MGUTILITY_CNSTXPR_CLANG_WA
#endif
 
#if MGUTILITY_CPLUSPLUS > 201703L
#define MGUTILITY_CNSTEVL consteval
#else
#define MGUTILITY_CNSTEVL
#endif
 
#if defined(__has_include) && !defined(MGUTILITY_HAS_HAS_INCLUDE)
#define MGUTILITY_HAS_HAS_INCLUDE
#endif
 
#endif // MGUTILITY_COMMON_DEFINITIONS_HPP
/*
MIT License
 
Copyright (c) 2024 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef MGUTILITY_DETAIL_UTILITY_HPP
#define MGUTILITY_DETAIL_UTILITY_HPP
 
#include <initializer_list>
#include <type_traits>
#include <utility>
 
namespace mgutility {
namespace detail {
 
template <std::size_t... Ints> struct index_sequence {};
 
template <typename Seq1, typename Seq2> struct index_sequence_concat;
 
template <std::size_t... I1, std::size_t... I2>
struct index_sequence_concat<index_sequence<I1...>, index_sequence<I2...>> {
  using type = index_sequence<I1..., (sizeof...(I1) + I2)...>;
};
 
template <std::size_t N> struct make_index_sequence_impl;
 
template <std::size_t N> struct make_index_sequence_impl {
private:
  static constexpr std::size_t half = N / 2;
 
  using first = typename make_index_sequence_impl<half>::type;
  using second = typename make_index_sequence_impl<N - half>::type;
 
public:
  using type = typename index_sequence_concat<first, second>::type;
};
 
// base cases
template <> struct make_index_sequence_impl<0> {
  using type = index_sequence<>;
};
 
template <> struct make_index_sequence_impl<1> {
  using type = index_sequence<0>;
};
 
template <std::size_t N>
using make_index_sequence = typename make_index_sequence_impl<N>::type;
} // namespace detail
 
} // namespace mgutility
 
#endif // DETAIL_META_HPP
#include <initializer_list>
#include <type_traits>
#include <utility>
 
namespace mgutility {
namespace detail {
 
#ifndef MGUTILITY_ENUM_RANGE_MIN
// NOLINTNEXTLINE [cppcoreguidelines-macro-usage]
#define MGUTILITY_ENUM_RANGE_MIN 0
#endif
 
#ifndef MGUTILITY_ENUM_RANGE_MAX
// NOLINTNEXTLINE [cppcoreguidelines-macro-usage]
#define MGUTILITY_ENUM_RANGE_MAX 256
#endif
 
#ifndef MGUTILITY_ENUM_NAME_BUFFER_SIZE
// NOLINTNEXTLINE [cppcoreguidelines-macro-usage]
#define MGUTILITY_ENUM_NAME_BUFFER_SIZE 32U
#endif
 
#ifndef MGUTILITY_GLOBAL_ENUM_BLOB_SIZE
// NOLINTNEXTLINE [cppcoreguidelines-macro-usage]
#define MGUTILITY_GLOBAL_ENUM_BLOB_SIZE 8192
#endif
 
#ifndef MGUTILITY_INLINE
#if MGUTILITY_CPLUSPLUS > 201402L
#define MGUTILITY_INLINE inline
#else
#define MGUTILITY_INLINE
#endif
#endif
 
template <typename E> struct is_scoped_enum {
  static constexpr auto value =
      // NOLINTNEXTLINE [modernize-type-traits]
      std::is_enum<E>::value &&
      // NOLINTNEXTLINE [modernize-type-traits]
      !std::is_convertible<E, typename std::underlying_type<E>::type>::value;
};
 
template <typename T, typename = void> struct has_bit_or : std::false_type {};
 
template <typename T>
struct has_bit_or<T, decltype((T{} | T{}), void())> : std::true_type {};
 
#if MGUTILITY_CPLUSPLUS > 201103L
template <typename E>
static constexpr bool is_scoped_enum_v = is_scoped_enum<E>::value;
#endif
 
template <bool B, class T = void>
// NOLINTNEXTLINE [modernize-type-traits]
using enable_if_t = typename std::enable_if<B, T>::type;
 
template <typename T>
// NOLINTNEXTLINE [modernize-type-traits]
using underlying_type_t = typename std::underlying_type<T>::type;
 
template <typename T>
// NOLINTNEXTLINE [modernize-type-traits]
using remove_const_t = typename std::remove_const<T>::type;
 
template <typename Enum, Enum... Values> struct enum_sequence {};
 
template <typename Enum, int Min, typename Seq> struct enum_sequence_from_index;
 
template <typename Enum, int Min, std::size_t... I>
struct enum_sequence_from_index<Enum, Min, index_sequence<I...>> {
private:
  // NOLINTNEXTLINE [readability-identifier-length]
  static constexpr int offset(std::size_t i) {
    return Min + static_cast<int>(i);
  }
 
public:
  using type = enum_sequence<Enum, static_cast<Enum>(offset(I))...>;
};
 
template <typename Enum, int Min, int Max>
using make_enum_sequence = typename enum_sequence_from_index<
    Enum, Min,
    make_index_sequence<static_cast<std::size_t>(Max - Min + 1)>>::type;
} // namespace detail
 
template <typename T> struct enum_range {
  static constexpr auto min{MGUTILITY_ENUM_RANGE_MIN};
  static constexpr auto max{MGUTILITY_ENUM_RANGE_MAX};
};
 
template <typename T, typename U> struct pair {
  T first;
  U second;
};
 
template <typename T>
#if MGUTILITY_CPLUSPLUS >= 201402L || defined(__GNUC__) && !defined(__clang__)
using flat_map = std::initializer_list<pair<T, const char *>>;
#else
// NOLINTNEXTLINE [cppcoreguidelines-avoid-c-arrays]
using flat_map = pair<T, const char *>[];
#endif
 
template <typename T> struct custom_enum {
  // #if MGUTILITY_CPLUSPLUS > 201402L
  static MGUTILITY_INLINE constexpr flat_map<T> map = {};
  // #else
  //     static constexpr flat_map<T> map() noexcept {
  //         return {}; // default: empty map
  //     }
  // #endif
};
 
template <typename T> struct enum_name_buffer {
  static constexpr auto size = MGUTILITY_ENUM_NAME_BUFFER_SIZE;
};
 
} // namespace mgutility
 
#endif // DETAIL_META_HPP
/*
MIT License
 
Copyright (c) 2025 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef MGUTILITY_FIXED_STRING_HPP
#define MGUTILITY_FIXED_STRING_HPP
 
/*
MIT License
 
Copyright (c) 2024 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef MGUTILITY_STRING_VIEW_HPP
#define MGUTILITY_STRING_VIEW_HPP
 
#include <cstring>
// NOLINTNEXTLINE [unused-includes]
#include <iosfwd>
#include <string>
#include <utility>
 
#if MGUTILITY_CPLUSPLUS > 201402L
#include <string_view>
#endif
 
namespace mgutility {
namespace detail {
 
// NOLINTNEXTLINE [readability-identifier-length]
constexpr auto strlen_constexpr(const char *str, size_t sz = 0) noexcept
    -> size_t {
  // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-pointer-arithmetic]
  return str[sz] == '\0' ? sz : strlen_constexpr(str, ++sz);
}
 
constexpr auto is_digit(char character) noexcept -> bool {
  return character >= '0' && character <= '9';
}
 
MGUTILITY_CNSTXPR int strncmp_constexpr(const char *lhs, const char *rhs,
                                        size_t count) noexcept {
  for (size_t i = 0; i < count; ++i) {
    // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-pointer-arithmetic]
    if (lhs[i] != rhs[i] || lhs[i] == '\0' || rhs[i] == '\0') {
      // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-pointer-arithmetic]
      return static_cast<unsigned char>(lhs[i]) -
             // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-pointer-arithmetic]
             static_cast<unsigned char>(rhs[i]);
    }
  }
  return 0;
}
 
template <typename Range, typename Pred>
MGUTILITY_CNSTXPR auto find(const Range &rng, const Pred &pred) -> size_t {
  for (size_t i = 1; i < rng.size(); ++i) {
    if (pred == rng[i]) {
      return i;
    }
  }
  return 0;
};
 
} // namespace detail
 
#if MGUTILITY_CPLUSPLUS < 201703L
 
// NOLINTNEXTLINE [cppcoreguidelines-special-member-functions]
template <typename Char = char> class basic_string_view {
public:
  // NOLINTNEXTLINE [readability-redundant-inline-specifier]
  constexpr inline basic_string_view() noexcept : data_(""), size_(0) {}
 
  // NOLINTNEXTLINE [google-explicit-constructor]
  constexpr inline basic_string_view(const Char *str) noexcept
      : data_(str), size_(detail::strlen_constexpr(str)) {}
 
  // NOLINTNEXTLINE [google-explicit-constructor]
  constexpr basic_string_view(const std::basic_string<Char> &str) noexcept
      : data_(str.c_str()), size_(str.size()) {}
 
  constexpr basic_string_view(const Char *str, size_t len) noexcept
      : data_(str), size_(len) {}
 
  constexpr basic_string_view(const basic_string_view &other)
      : data_(other.data_), size_(other.size_) {}
 
  constexpr basic_string_view(basic_string_view &&other) noexcept
      : data_(std::move(other.data_)), size_(other.size_) {}
 
  MGUTILITY_CNSTXPR inline basic_string_view<Char> &
  operator=(const basic_string_view &other) noexcept = default;
 
  MGUTILITY_CNSTXPR inline basic_string_view<Char> &
  operator=(basic_string_view &&other) noexcept {
    data_ = std::move(other.data_);
    size_ = other.size_;
    return *this;
  }
 
  // NOLINTNEXTLINE [readability-const-return-type]
  constexpr const Char operator[](size_t index) const noexcept {
    // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-pointer-arithmetic]
    return data_[index];
  }
 
  constexpr const Char *begin() const noexcept { return data_; }
 
  constexpr const Char *end() const noexcept { return (data_ + size_); }
 
  constexpr const Char &front() const noexcept { return data_[0]; }
 
  constexpr const Char &back() const noexcept { return data_[size_ - 1]; }
 
  constexpr bool empty() const noexcept { return size_ < 1; }
 
  constexpr size_t size() const noexcept { return size_; }
 
  constexpr const Char *data() const noexcept { return data_; }
 
  constexpr basic_string_view<Char> substr(size_t begin,
                                           size_t len = npos) const noexcept {
    return basic_string_view<Char>(data_ + begin,
                                   len == npos ? size_ - begin : len);
  }
 
  // NOLINTNEXTLINE [readability-identifier-length]
  constexpr size_t rfind(Char c, size_t pos = npos) const noexcept {
#if MGUTILITY_CPLUSPLUS < 201402L
    // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-pointer-arithmetic]
    return (pos == npos ? pos = size_ : pos = pos),
           c == data_[pos] ? pos
           // NOLINTNEXTLINE [readability-avoid-nested-conditional-operator]
           : pos == 0U ? npos
                       : rfind(c, --pos);
#else
    for (size_t i = (pos == npos ? size_ : pos) - 1; i < size_; --i) {
      if (data_[i] == c) {
        return i;
      }
    }
    return npos;
#endif
  }
 
  // NOLINTNEXTLINE [readability-identifier-length]
  constexpr size_t find(Char c, size_t pos = 0) const noexcept {
#if MGUTILITY_CPLUSPLUS < 201402L
    // NOLINTNEXTLINE [readability-avoid-nested-conditional-operator]
    return c == data_[pos] ? pos : pos < size_ ? find(c, ++pos) : npos;
#else
    for (size_t i = pos; i < size_; ++i) {
      if (data_[i] == c) {
        return i;
      }
    }
    return npos;
#endif
  }
 
  MGUTILITY_CNSTXPR friend bool
  operator==(basic_string_view<Char> lhs,
             basic_string_view<Char> rhs) noexcept {
    return (lhs.size_ == rhs.size_) &&
           detail::strncmp_constexpr(lhs.data_, rhs.data_, lhs.size_) == 0;
  }
 
  MGUTILITY_CNSTXPR friend bool operator==(basic_string_view<Char> lhs,
                                           const Char *rhs) noexcept {
    return ((lhs.size_ == detail::strlen_constexpr(rhs)) &&
            (detail::strncmp_constexpr(lhs.data_, rhs, lhs.size_) == 0));
  }
 
  MGUTILITY_CNSTXPR friend bool
  operator!=(basic_string_view<Char> lhs,
             basic_string_view<Char> rhs) noexcept {
    return !(lhs == rhs);
  }
 
  MGUTILITY_CNSTXPR friend bool operator!=(basic_string_view<Char> lhs,
                                           const Char *rhs) noexcept {
    return !(lhs == rhs);
  }
 
  // NOLINTNEXTLINE [google-explicit-constructor]
  operator std::string() { return std::string(data_, size_); }
 
  // NOLINTNEXTLINE [google-explicit-constructor]
  operator std::string() const { return std::string(data_, size_); }
 
  // NOLINTNEXTLINE [readability-identifier-length]
  friend std::ostream &
  operator<<(std::ostream &os,
             // NOLINTNEXTLINE [readability-identifier-length]
             const basic_string_view<Char> &sv) {
    // NOLINTNEXTLINE [readability-identifier-length]
    for (auto c : sv) {
      os << c;
    }
    return os;
  }
 
  static constexpr auto npos = -1;
 
private:
  size_t size_;
  const Char *data_;
};
 
using string_view = basic_string_view<char>;
 
#else
 
using string_view = std::string_view;
 
#endif
 
} // namespace mgutility
 
#endif // STRING_STRING_VIEW_HPP
 
namespace mgutility {
 
template <size_t N = 0> class fixed_string {
  template <size_t> friend class fixed_string;
 
public:
  template <size_t M>
  // NOLINTNEXTLINE [cppcoreguidelines-avoid-c-arrays]
  MGUTILITY_CNSTXPR static auto make(const char (&str)[M]) -> fixed_string<M> {
    return fixed_string<M>{str};
  }
 
  MGUTILITY_CNSTXPR fixed_string() = default;
 
  // --- safe pack expansion (no OOB) ---
  template <std::size_t M, std::size_t... Is>
  constexpr fixed_string(const char (&str)[M], detail::index_sequence<Is...>)
      : data_{(Is < M ? str[Is] : '\0')...}, cursor_(M ? M - 1 : 0) {}
 
  // single literal constructor (handles all M)
  template <std::size_t M>
  constexpr fixed_string(const char (&str)[M])
      : fixed_string(str, typename detail::make_index_sequence<N>{}) {}
 
  MGUTILITY_CNSTXPR fixed_string(const char *str, std::size_t len)
      : data_{}, cursor_(len < N ? len
                         : N     ? N - 1
                                 : 0) {
    for (std::size_t i = 0; i < N; ++i) {
      data_[i] = (i < len) ? str[i] : '\0';
    }
  }
 
  MGUTILITY_CNSTXPR fixed_string(mgutility::string_view str)
      : fixed_string(str.data(), str.size()) {}
 
  // Constructor to initialize from a string literal
  // NOLINTNEXTLINE [cppcoreguidelines-avoid-c-arrays]
  MGUTILITY_CNSTXPR explicit fixed_string(const char (&str)[N]) {
    for (size_t i = 0; i < N - 1; ++i) {
      data_[i] = str[i];
    }
    cursor_ = N - 1;
    data_[cursor_] = '\0';
  }
 
  // Concatenation operator
  template <size_t M>
  MGUTILITY_CNSTXPR auto operator+(const fixed_string<M> &other) const
      -> fixed_string<N + M - 1> {
    fixed_string<N + M - 1> result{};
    size_t idx = 0;
    for (; idx < cursor_; ++idx) {
      // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
      result.data_[idx] = data_[idx];
    }
    for (size_t j = 0; j < other.size(); ++j) {
      // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
      result.data_[idx + j] = other.data_[j];
    }
    result.cursor_ = cursor_ + other.size();
    // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
    result.data_[result.cursor_] = '\0';
    return result;
  }
 
  // Concatenation operator
  template <size_t M>
  // NOLINTNEXTLINE [cppcoreguidelines-avoid-c-arrays]
  MGUTILITY_CNSTXPR auto operator+(const char (&str)[M]) const
      -> fixed_string<N + M - 1> {
    return *this + fixed_string<M>{str};
  }
 
  template <size_t M>
  // NOLINTNEXTLINE [cppcoreguidelines-avoid-c-arrays]
  MGUTILITY_CNSTXPR auto append(const char (&str)[M]) -> fixed_string<N> & {
    static_assert(N > M,
                  "Capacity needs to be greater than string to be appended!");
    for (size_t i = 0; i < M - 1; ++i) {
      // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
      data_[cursor_++] = str[i];
    }
    // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
    data_[cursor_] = '\0';
    return *this;
  }
 
  MGUTILITY_CNSTXPR auto append(string_view str) -> fixed_string<N> & {
    auto len = str.size() > N - cursor_ ? N - cursor_ : str.size();
    for (std::size_t i = 0; i < len; ++i) {
      // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
      data_[cursor_++] = str[i];
    }
    // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
    data_[cursor_] = '\0';
    return *this;
  }
 
  MGUTILITY_CNSTXPR auto pop_back() -> void {
    if (cursor_ > 0) {
      // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
      data_[--cursor_] = '\0';
    }
  }
 
  MGUTILITY_CNSTXPR auto size() const -> size_t { return cursor_; }
 
  // NOLINTNEXTLINE [readability-identifier-length]
  constexpr size_t find(char c, size_t pos = 0) const noexcept {
    // NOLINTNEXTLINE [readability-avoid-nested-conditional-operator]
    return c == data_[pos] ? pos : (pos < cursor_ ? find(c, ++pos) : npos);
  }
 
  // Conversion to std::string_view for easy printing
  // NOLINTNEXTLINE[google-explicit-constructor]
  MGUTILITY_CNSTXPR operator string_view() const {
    return string_view(data_, cursor_);
  }
 
  MGUTILITY_CNSTXPR auto view() const -> string_view {
    return string_view(data_, cursor_);
  }
 
  constexpr const char *data() const noexcept { return data_; }
 
  constexpr bool empty() const noexcept { return cursor_ == 0; }
 
  constexpr const char &operator[](size_t index) const noexcept {
    // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
    return data_[index];
  }
 
  MGUTILITY_CNSTXPR inline bool operator==(const char *rhs) const {
    return view() == rhs;
  }
 
  // NOLINTNEXTLINE [readability-identifier-length]
  friend std::ostream &operator<<(std::ostream &os,
                                  const fixed_string<N> &str) {
    for (size_t i = 0; i < str.cursor_; ++i) {
      // NOLINTNEXTLINE [cppcoreguidelines-pro-bounds-constant-array-index]
      os << str.data_[i];
    }
    return os;
  }
 
  static constexpr auto npos = -1;
 
private:
  // NOLINTNEXTLINE [cppcoreguidelines-avoid-c-arrays]
  char data_[N]{'\0'};
  size_t cursor_{};
};
 
} // namespace mgutility
 
#if defined(__cpp_lib_format)
 
#include <format>
 
template <size_t N>
struct std::formatter<mgutility::fixed_string<N>>
    : formatter<std::string_view> {
  auto constexpr format(const mgutility::fixed_string<N> &str,
                        format_context &ctx) const {
    return formatter<std::string_view>::format(str.view().data(), ctx);
  }
};
 
#endif
 
#if defined(ENUM_NAME_USE_FMT) ||                                              \
    (defined(MGUTILITY_HAS_HAS_INCLUDE) && __has_include(<fmt/format.h>))
#include <fmt/format.h>
 
template <size_t N>
struct fmt::formatter<mgutility::fixed_string<N>> : formatter<string_view> {
  auto format(const mgutility::fixed_string<N> &str, format_context &ctx) const
      -> appender {
    return formatter<string_view>::format(str.view().data(), ctx);
  }
};
#endif // MGUTILITY_USE_FMT || __has_include(<fmt/format.h>)
 
#endif // MGUTILITY_FIXED_STRING_HPP
 
// NOLINTNEXTLINE [unused-includes]
#include <cstdint>
#include <utility>
 
namespace mgutility {
namespace detail {
 
template <typename T>
// NOLINTNEXTLINE [modernize-type-traits]
using string_or_view_t = typename std::conditional<
    has_bit_or<T>::value, mgutility::fixed_string<enum_name_buffer<T>::size>,
    mgutility::string_view>::type;
 
template <typename Enum>
using enum_pair = std::pair<Enum, detail::string_or_view_t<Enum>>;
} // namespace detail
 
template <typename Enum> class enum_for_each {
  using value_type = const detail::enum_pair<Enum>;
  using size_type = std::size_t;
 
  struct enum_iter {
    using const_iter_type = int;
    using iter_type = detail::remove_const_t<const_iter_type>;
    using iterator_category = std::forward_iterator_tag;
    using value_type = const detail::enum_pair<Enum>;
    using difference_type = std::ptrdiff_t;
    using pointer = value_type *;
    using reference = value_type &;
 
    enum_iter() : m_pos{} {}
 
    explicit enum_iter(iter_type value) : m_pos{value} {}
 
    auto operator++() -> enum_iter & {
      ++m_pos;
      return *this;
    }
 
    auto operator++(int) -> enum_iter {
      m_pos++;
      return *this;
    }
 
    auto operator!=(const enum_iter &other) const -> bool {
      return m_pos != other.m_pos;
    }
 
    auto operator==(const enum_iter &other) const -> bool {
      return m_pos == other.m_pos;
    }
 
    auto operator*() const -> value_type;
 
  private:
    iter_type m_pos; 
  };
 
public:
  enum_for_each() = default;
 
  auto begin() -> enum_iter & { return m_begin; }
 
  auto end() -> enum_iter & { return m_end; }
 
  auto size() -> std::size_t {
    return static_cast<int>(enum_range<Enum>::max) -
           static_cast<int>(enum_range<Enum>::min) + 1;
  }
 
private:
  enum_iter m_begin{
      static_cast<int>(enum_range<Enum>::min)}; 
  enum_iter m_end{static_cast<int>(enum_range<Enum>::max) +
                  1}; 
};
} // namespace mgutility
 
#endif // DETAIL_ENUM_FOR_EACH_HPP
/*
MIT License
 
Copyright (c) 2024 mguludag
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
*/
 
#ifndef DETAIL_OPTIONAL_HPP
#define DETAIL_OPTIONAL_HPP
 
// NOLINTNEXTLINE [unused-includes]
 
// NOLINTNEXTLINE [unused-includes]
#include <exception>
 
#if MGUTILITY_CPLUSPLUS >= 201703L
#include <optional>
#endif
 
namespace mgutility {
 
#if MGUTILITY_CPLUSPLUS < 201703L
 
struct bad_optional_access : public std::exception {
  const char *what() const noexcept override { return "optional has no value"; }
};
 
struct nullopt_t;
 
template <typename T> class optional {
public:
  MGUTILITY_CNSTXPR inline explicit optional(nullopt_t & /*unused*/)
      : dummy_{0}, has_value_{false} {}
 
  MGUTILITY_CNSTXPR inline optional() : dummy_{0}, has_value_{false} {}
 
  template <typename... Args>
  MGUTILITY_CNSTXPR inline explicit optional(Args &&...args)
      : value_{T{std::forward<Args>(args)...}}, has_value_{true} {}
 
  MGUTILITY_CNSTXPR inline explicit optional(T &&value)
      : value_{std::move(value)}, has_value_{true} {}
 
  MGUTILITY_CNSTXPR inline optional(const optional &other)
      : value_{other.value_}, has_value_{other.has_value_} {}
 
  MGUTILITY_CNSTXPR inline optional(optional &&other) noexcept
      : value_{other.value_}, has_value_{other.has_value_} {
    other.reset();
  }
 
  ~optional() = default;
 
  MGUTILITY_CNSTXPR inline optional &operator=(const optional &other) {
    value_ = other.value_;
    has_value_ = other.has_value_;
    return *this;
  }
 
  MGUTILITY_CNSTXPR inline optional &operator=(optional &&other) noexcept {
    value_ = other.value_;
    has_value_ = other.has_value_;
    other.reset();
    return *this;
  }
 
  MGUTILITY_CNSTXPR inline void swap(optional &other) noexcept {
    auto val = std::move(other.value_);
    other.value_ = std::move(value_);
    value_ = std::move(val);
 
    auto hval = other.has_value_;
    other.has_value_ = has_value_;
    has_value_ = hval;
  }
 
  MGUTILITY_CNSTXPR inline T &operator*() { return value_; }
 
  MGUTILITY_CNSTXPR inline T &operator*() const { return value_; }
 
  MGUTILITY_CNSTXPR inline T &value() {
    if (!has_value_) {
      throw bad_optional_access();
    }
    return value_;
  }
 
  MGUTILITY_CNSTXPR inline T &value() const {
    if (!has_value_) {
      throw bad_optional_access();
    }
    return value_;
  }
 
  MGUTILITY_CNSTXPR inline T value_or(T &&value) {
    return has_value_ ? value_ : std::move(value);
  }
 
  MGUTILITY_CNSTXPR inline T value_or(T &&value) const {
    return has_value_ ? value_ : std::move(value);
  }
 
  MGUTILITY_CNSTXPR inline T value_or(const T &value) {
    return has_value_ ? value_ : value;
  }
 
  MGUTILITY_CNSTXPR inline T value_or(const T &value) const {
    return has_value_ ? value_ : value;
  }
 
  MGUTILITY_CNSTXPR inline void emplace(T value) {
    value_ = std::move(value);
    has_value_ = true;
  }
 
  template <typename... Args>
  MGUTILITY_CNSTXPR inline void emplace(Args &&...args) {
    value_ = std::move(T{std::forward<Args>(args)...});
    has_value_ = true;
  }
 
  MGUTILITY_CNSTXPR inline bool has_value() const { return has_value_; }
 
  template <typename U = T,
            detail::enable_if_t<!std::is_destructible<U>::value, bool> = true>
  MGUTILITY_CNSTXPR inline void reset() {
    value_ = T{};
    has_value_ = false;
  }
 
  template <typename U = T,
            detail::enable_if_t<std::is_destructible<T>::value, bool> = true>
  MGUTILITY_CNSTXPR inline void reset() {
    value_.~T();
    has_value_ = false;
  }
 
  MGUTILITY_CNSTXPR operator bool() { return has_value_; }
 
private:
  union {
    T value_;
    char dummy_[sizeof(T)];
  };
  bool has_value_;
};
 
struct nullopt_t {
  template <typename T> MGUTILITY_CNSTXPR operator optional<T>() {
    return optional<T>{};
  }
};
 
auto nullopt = nullopt_t{};
 
#else
template <typename T> using optional = std::optional<T>;
 
inline constexpr auto nullopt{std::nullopt};
 
#endif
} // namespace mgutility
 
#endif // DETAIL_OPTIONAL_HPP
#include <algorithm>
#include <array>
#include <cstddef>
#include <cstring>
 
#if defined(_MSC_VER) && _MSC_VER < 1910
#error "Requires MSVC 2017 or newer!"
#elif defined(__clang__) && __clang_major__ < 6
#error "Requires clang 6 or newer!"
#elif defined(__GNUC__) && !defined(__clang__) && __GNUC__ < 9
#error "Requires gcc 9 or newer!"
#elif !defined(_MSC_VER) && !defined(__clang__) && !defined(__GNUC__)
#error "Your compiler is not supported!"
#endif
 
#ifdef _MSC_VER
#define __PRETTY_FUNCTION__ __FUNCSIG__
#endif
 
// NOLINTNEXTLINE [modernize-concat-nested-namespaces]
namespace mgutility {
namespace detail {
 
#ifndef MGUTILITY_STRLEN
// NOLINTNEXTLINE [cppcoreguidelines-macro-usage]
#define MGUTILITY_STRLEN(x) sizeof(x) - 1
#endif
 
template <typename U, int Min, int Max> struct enum_name_parse_result {
  static constexpr auto size = std::size_t{Max - Min};
  fixed_string<MGUTILITY_GLOBAL_ENUM_BLOB_SIZE> strings;
  std::array<pair<std::size_t, std::size_t>, size> ranges;
};
 
template <typename T, int Min, int Max>
using enum_name_array =
    std::array<mgutility::string_view, static_cast<std::size_t>(Max - Min)>;
 
struct enum_type {
private:
  template <typename Enum, Enum... e>
  MGUTILITY_CNSTXPR static auto
  raw_name(detail::enum_sequence<Enum, e...> /*unused*/) noexcept
      -> mgutility::string_view {
#if defined(__GNUC__) && !defined(__clang__) && MGUTILITY_CPLUSPLUS >= 201402L
#define PREFIX                                                                 \
  MGUTILITY_STRLEN("static constexpr mgutility::string_view "                  \
                   "mgutility::detail::enum_type::raw_name(mgutility::detail:" \
                   ":enum_sequence<Enum, e ...>) [with Enum = ")
#elif defined(__clang__) || defined(__GNUC__)
#define PREFIX                                                                 \
  MGUTILITY_STRLEN("static mgutility::string_view "                            \
                   "mgutility::detail::enum_type::raw_name(mgutility::detail:" \
                   ":enum_sequence<Enum, e ...>) [with Enum = ")
#elif defined(_MSC_VER)
#if MGUTILITY_CPLUSPLUS > 201402L
#define PREFIX                                                                 \
  MGUTILITY_STRLEN(                                                            \
      "class std::basic_string_view<char,struct std::char_traits<char> > "     \
      "__cdecl mgutility::detail::enum_type::raw_name")
#else
#define PREFIX                                                                 \
  MGUTILITY_STRLEN("class mgutility::basic_string_view<char> __cdecl "         \
                   "mgutility::detail::enum_type::raw_name")
#endif
#else
#define PREFIX 0
#endif
 
    return mgutility::string_view(__PRETTY_FUNCTION__ + PREFIX,
                                  MGUTILITY_STRLEN(__PRETTY_FUNCTION__) -
                                      PREFIX + 1);
  }
 
  template <typename Enum, int Min, int Max>
  MGUTILITY_CNSTXPR static auto parse() noexcept
      -> enum_name_parse_result<detail::underlying_type_t<Enum>, Min, Max> {
    using U = detail::underlying_type_t<Enum>;
    using result_type = enum_name_parse_result<U, Min, Max>;
 
    MGUTILITY_CNSTXPR auto str =
        raw_name<Enum>(detail::make_enum_sequence<Enum, Min, Max>{});
 
#if defined(__clang__) || defined(__GNUC__)
#if defined(__clang__)
    auto end = str.rfind(']');
#elif defined(__GNUC__) && !defined(__clang__)
    auto end = str.rfind(';');
#endif
 
    auto enum_names = str.substr(0, end);
 
#elif defined(_MSC_VER)
    // MSVC: different format
    auto pos = str.find(',');
    if (pos == mgutility::string_view::npos)
      return {};
 
    ++pos;
 
    auto end = str.rfind('>');
    auto enum_names = str.substr(pos, end - pos);
 
#else
    return {};
#endif
 
    if (enum_names.empty()) {
      return {};
    }
 
    result_type result{};
 
    std::size_t idx = 0;
 
    while (!enum_names.empty() && idx < result.ranges.size()) {
      auto pos = enum_names.find(',');
      if (pos != mgutility::string_view::npos) {
        auto token = enum_names.substr(0, pos);
 
        // remove whitespace
        while (!token.empty() && token.front() == ' ') {
          token = token.substr(1);
        }
 
        while (!token.empty() && token.back() == ' ') {
          token = token.substr(0, token.size() - 1);
        }
 
        std::size_t begin = token.find('(');
        std::size_t end = token.rfind(')');
        if (begin != mgutility::string_view::npos ||
            end != mgutility::string_view::npos) {
          result.ranges[idx++] = {0, 0};
          enum_names = enum_names.substr(pos + 1);
          continue;
        }
 
        std::size_t start = 0;
        if (token.find(':') != mgutility::string_view::npos) {
          start = token.find(':') + 2;
          token = token.substr(start);
        }
 
        // Write into the fixed-size global buffer
        auto offset = result.strings.size();
        result.strings.append(token);
        result.ranges[idx++] = {offset, token.size()};
 
        enum_names = enum_names.substr(pos + 1);
        continue;
      }
      enum_names = {};
    }
 
    return result;
  }
 
public:
  template <typename Enum, int Min, int Max>
  MGUTILITY_CNSTXPR static auto name() noexcept
      -> enum_name_parse_result<detail::underlying_type_t<Enum>, Min, Max> {
    return parse<Enum, Min, Max>();
  }
};
 
template <typename Enum, int Min, int Max> struct enum_array_cache;
 
template <typename Enum, int Min, int Max> struct enum_array_cache {
  using underlying = detail::underlying_type_t<Enum>;
  using parse_result_t = enum_name_parse_result<underlying, Min, Max>;
 
#if MGUTILITY_CPLUSPLUS > 201402L
 
  static constexpr auto parse_result =
      enum_type::template name<Enum, Min, Max>();
 
#else
  // C++11: lazy runtime array
  static parse_result_t &value() {
    static parse_result_t arr = enum_type::template name<Enum, Min, Max>();
 
    return arr;
  }
#endif
 
  static MGUTILITY_CNSTXPR auto
  apply_custom(const parse_result_t &result) noexcept
      -> enum_name_array<Enum, Min, Max> {
    enum_name_array<Enum, Min, Max> arr{};
 
    for (std::size_t idx = 0; idx < result.ranges.size(); ++idx) {
      arr[idx] = result.strings.view().substr(result.ranges[idx].first,
                                              result.ranges[idx].second);
    }
 
#if MGUTILITY_CPLUSPLUS >= 201402L
    constexpr auto map = mgutility::custom_enum<Enum>::map;
    for (const auto &pair : map) {
#else
    for (const auto &pair : mgutility::custom_enum<Enum>::map) {
#endif
      if (pair.first >= static_cast<Enum>(Min) &&
          pair.first < static_cast<Enum>(Max)) {
        arr[static_cast<std::size_t>(pair.first) - Min] = pair.second;
      }
    }
 
    return arr;
  }
};
 
template <typename Enum, int Min = mgutility::enum_range<Enum>::min,
          int Max = mgutility::enum_range<Enum>::max>
MGUTILITY_CNSTXPR auto get_enum_array() noexcept
    -> enum_name_array<Enum, Min, Max> {
#if MGUTILITY_CPLUSPLUS > 201402L
  constexpr auto &cache = enum_array_cache<Enum, Min, Max>::parse_result;
  return enum_array_cache<Enum, Min, Max>::apply_custom(cache);
#else
  return enum_array_cache<Enum, Min, Max>::apply_custom(
      enum_array_cache<Enum, Min, Max>::value());
#endif
}
 
template <typename Enum, int Min, int Max>
MGUTILITY_CNSTXPR inline auto to_enum_impl(mgutility::string_view str) noexcept
    -> mgutility::optional<Enum> {
  MGUTILITY_CNSTXPR_CLANG_WA auto arr = get_enum_array<Enum, Min, Max>();
 
  const auto index{detail::find(arr, str)};
  return index == 0 ? mgutility::nullopt
                    : mgutility::optional<Enum>{static_cast<Enum>(index + Min)};
}
 
template <typename Enum, int Min, int Max>
MGUTILITY_CNSTXPR auto to_enum_bitmask_impl(mgutility::string_view str) noexcept
    -> mgutility::optional<Enum> {
 
  // Check if the string contains a '|' character
  if (str.find('|') == mgutility::string_view::npos) {
    return to_enum_impl<Enum, Min, Max>(str);
  }
 
  mgutility::optional<Enum> result{mgutility::nullopt};
  std::size_t index = 0;
 
  for (std::size_t i = 0; i < str.size(); ++i) {
    if (str[i] == '|') {
      auto name = str.substr(index, i - index);
      auto maybe_enum = to_enum_impl<Enum, Min, Max>(name);
 
      if (!name.empty() && maybe_enum) {
        result.emplace(result ? static_cast<Enum>(*result | *maybe_enum)
                              : *maybe_enum);
      }
 
      index = i + 1;
    }
  }
 
  auto maybe_enum = to_enum_impl<Enum, Min, Max>(str.substr(index));
  if (result && maybe_enum) {
    result.emplace(static_cast<Enum>(*result | *maybe_enum));
  } else {
    result.reset();
  }
 
  return result;
}
 
template <typename Enum, int Min, int Max,
          detail::enable_if_t<!detail::has_bit_or<Enum>::value, bool> = true>
MGUTILITY_CNSTXPR auto enum_name_impl(Enum enumValue) noexcept
    -> mgutility::string_view {
  MGUTILITY_CNSTXPR_CLANG_WA auto arr = get_enum_array<Enum, Min, Max>();
  const auto index{(Min < 0 ? -Min : Min) + static_cast<int>(enumValue)};
  if (index < Min || index > static_cast<int>(arr.size()) - 1) {
    return mgutility::string_view{};
  }
 
  return arr[static_cast<size_t>(index)];
}
 
// NOLINTNEXTLINE [modernize-use-constraints]
template <typename Enum, int Min, int Max,
          detail::enable_if_t<detail::has_bit_or<Enum>::value, bool> = true>
MGUTILITY_CNSTXPR_CLANG_WA auto enum_name_impl(Enum enumValue) noexcept
    -> mgutility::fixed_string<enum_name_buffer<Enum>::size> {
 
  // Get the array of enum names
  MGUTILITY_CNSTXPR_CLANG_WA auto arr = get_enum_array<Enum, Min, Max>();
 
  // Calculate the index in the array
  const auto index = (Min < 0 ? -Min : Min) + static_cast<int>(enumValue);
 
  mgutility::fixed_string<enum_name_buffer<Enum>::size> bitmasked_name;
 
  if (index >= 0 && index < static_cast<int>(arr.size())) {
    bitmasked_name.append(arr[static_cast<size_t>(index)]);
  }
 
  if (!bitmasked_name.empty()) {
    return bitmasked_name;
  }
 
  for (auto i = 0; i < Max - Min; ++i) {
    if (i >= 0 && i < static_cast<int>(arr.size()) && arr[i].size() > 0 &&
        (enumValue & static_cast<Enum>(i)) == static_cast<Enum>(i)) {
      bitmasked_name.append(arr[i]).append("|");
    }
  }
 
  // Remove the trailing '|' if present
  if (!bitmasked_name.empty()) {
    bitmasked_name.pop_back();
  }
 
  return bitmasked_name;
}
} // namespace detail
} // namespace mgutility
 
#endif // MGUTILITY_REFLECTION_DETAIL_ENUM_NAME_IMPL_HPP
namespace mgutility {
 
template <typename Enum,
          // NOLINTNEXTLINE [modernize-type-traits]
          detail::enable_if_t<std::is_enum<Enum>::value, bool> = true>
constexpr auto to_underlying(Enum enumValue) noexcept
    -> detail::underlying_type_t<Enum> {
  // NOLINTNEXTLINE [modernize-type-traits]
  static_assert(std::is_enum<Enum>::value, "Value is not an Enum type!");
  return static_cast<detail::underlying_type_t<Enum>>(enumValue);
}
 
template <int Min, int Max, typename Enum>
MGUTILITY_CNSTXPR auto enum_name(Enum enumValue) noexcept
    -> detail::string_or_view_t<Enum> {
  static_assert(Min < Max, "Max must be greater than Min!");
  // NOLINTNEXTLINE [modernize-type-traits]
  static_assert(std::is_enum<Enum>::value, "Value is not an Enum type!");
  return detail::enum_name_impl<Enum, Min, Max>(enumValue);
}
 
template <typename Enum, int Min = static_cast<int>(enum_range<Enum>::min),
          int Max = static_cast<int>(enum_range<Enum>::max)>
MGUTILITY_CNSTXPR auto enum_name(Enum enumValue) noexcept
    -> detail::string_or_view_t<Enum> {
  static_assert(Min < Max, "Max must be greater than Min!");
  // NOLINTNEXTLINE [modernize-type-traits]
  static_assert(std::is_enum<Enum>::value, "Value is not an Enum type!");
  return detail::enum_name_impl<Enum, Min, Max>(enumValue);
}
 
template <typename Enum>
auto enum_for_each<Enum>::enum_iter::operator*() const -> value_type {
  auto value = static_cast<Enum>(m_pos);
  return detail::enum_pair<Enum>{value, enum_name(value)};
}
 
template <typename Enum, int Min = static_cast<int>(enum_range<Enum>::min),
          int Max = static_cast<int>(enum_range<Enum>::max),
          detail::enable_if_t<!detail::has_bit_or<Enum>::value, bool> = true>
MGUTILITY_CNSTXPR auto to_enum(mgutility::string_view str) noexcept
    -> mgutility::optional<Enum> {
  static_assert(Min < Max, "Max must be greater than Min!");
  // NOLINTNEXTLINE [modernize-type-traits]
  static_assert(std::is_enum<Enum>::value, "Type is not an Enum type!");
  return detail::to_enum_impl<Enum, Min, Max>(str);
}
 
template <typename Enum, int Min = static_cast<int>(enum_range<Enum>::min),
          int Max = static_cast<int>(enum_range<Enum>::max),
          detail::enable_if_t<detail::has_bit_or<Enum>::value, bool> = true>
MGUTILITY_CNSTXPR auto to_enum(mgutility::string_view str) noexcept
    -> mgutility::optional<Enum> {
  static_assert(Min < Max, "Max must be greater than Min!");
  // NOLINTNEXTLINE [modernize-type-traits]
  static_assert(std::is_enum<Enum>::value, "Type is not an Enum type!");
  return detail::to_enum_bitmask_impl<Enum, Min, Max>(str);
}
 
template <typename Enum, int Min = static_cast<int>(enum_range<Enum>::min),
          int Max = static_cast<int>(enum_range<Enum>::max)>
MGUTILITY_CNSTXPR auto enum_cast(int value) noexcept
    -> mgutility::optional<Enum> {
  static_assert(Min < Max, "Max must be greater than Min!");
  // NOLINTNEXTLINE [modernize-type-traits]
  static_assert(std::is_enum<Enum>::value, "Type is not an Enum type!");
  if (enum_name(static_cast<Enum>(value)).empty()) {
    return mgutility::nullopt;
  }
  return mgutility::optional<Enum>{static_cast<Enum>(value)};
}
 
namespace operators {
template <typename Enum, mgutility::detail::enable_if_t<
                             // NOLINTNEXTLINE [modernize-type-traits]
                             std::is_enum<Enum>::value, bool> = true>
constexpr auto operator&(const Enum &lhs, const Enum &rhs) -> Enum {
  return static_cast<Enum>(mgutility::to_underlying(lhs) &
                           mgutility::to_underlying(rhs));
}
 
template <typename Enum, mgutility::detail::enable_if_t<
                             // NOLINTNEXTLINE [modernize-type-traits]
                             std::is_enum<Enum>::value, bool> = true>
constexpr auto operator|(const Enum &lhs, const Enum &rhs) -> Enum {
  return static_cast<Enum>(mgutility::to_underlying(lhs) |
                           mgutility::to_underlying(rhs));
}
} // namespace operators
 
} // namespace mgutility
 
template <typename Enum, mgutility::detail::enable_if_t<
                             // NOLINTNEXTLINE [modernize-type-traits]
                             std::is_enum<Enum>::value, bool> = true>
auto operator<<(std::ostream &outStream, Enum enumVal) -> std::ostream & {
  // NOLINTNEXTLINE [modernize-type-traits]
  static_assert(std::is_enum<Enum>::value, "Value is not an Enum type!");
  outStream << mgutility::enum_name(enumVal);
  return outStream;
}
 
#if defined(__cpp_lib_format)
 
#include <format>
 
template <typename Enum>
  requires std::is_enum_v<Enum>
struct std::formatter<Enum> : formatter<std::string_view> {
  // NOLINTNEXTLINE [readability-identifier-length]
  auto constexpr format(Enum e, format_context &ctx) const {
    return formatter<std::string_view>::format(mgutility::enum_name(e), ctx);
  }
};
 
#endif
 
#if defined(ENUM_NAME_USE_FMT) ||                                              \
    (defined(MGUTILITY_HAS_HAS_INCLUDE) && __has_include(<fmt/format.h>))
#include <fmt/format.h>
 
template <class Enum>
struct fmt::formatter<Enum, char,
                      // NOLINTNEXTLINE [modernize-type-traits]
                      mgutility::detail::enable_if_t<std::is_enum<Enum>::value>>
    : formatter<string_view> {
  // NOLINTNEXTLINE [readability-identifier-length]
  auto format(const Enum e, format_context &ctx) const -> appender {
    return formatter<string_view>::format(
        static_cast<mgutility::string_view>(mgutility::enum_name(e)).data(),
        ctx);
  }
};
#endif // MGUTILITY_USE_FMT || __has_include(<fmt/format.h>)
 
#endif // MGUTILITY_ENUM_NAME_HPP