// __ __ _ ______ _____ // | \/ | (_) | ____| / ____|_ _ // | \ / | __ _ __ _ _ ___ | |__ _ __ _ _ _ __ ___ | | _| |_ _| |_ // | |\/| |/ _` |/ _` | |/ __| | __| | '_ \| | | | '_ ` _ \ | | |_ _|_ _| // | | | | (_| | (_| | | (__ | |____| | | | |_| | | | | | | | |____|_| |_| // |_| |_|\__,_|\__, |_|\___| |______|_| |_|\__,_|_| |_| |_| \_____| // __/ | https://github.com/Neargye/magic_enum // |___/ version 0.7.2 // // Licensed under the MIT License . // SPDX-License-Identifier: MIT // Copyright (c) 2019 - 2021 Daniil Goncharov . // // 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 NEARGYE_MAGIC_ENUM_HPP #define NEARGYE_MAGIC_ENUM_HPP #define MAGIC_ENUM_VERSION_MAJOR 0 #define MAGIC_ENUM_VERSION_MINOR 7 #define MAGIC_ENUM_VERSION_PATCH 2 #include #include #include #include #include #include #include #include #if !defined(MAGIC_ENUM_USING_ALIAS_OPTIONAL) #include #endif #if !defined(MAGIC_ENUM_USING_ALIAS_STRING) #include #endif #if !defined(MAGIC_ENUM_USING_ALIAS_STRING_VIEW) #include #endif #if defined(__clang__) # pragma clang diagnostic push #elif defined(__GNUC__) # pragma GCC diagnostic push # pragma GCC diagnostic ignored "-Wmaybe-uninitialized" // May be used uninitialized 'return {};'. #elif defined(_MSC_VER) # pragma warning(push) # pragma warning(disable : 26495) // Variable 'static_string::chars_' is uninitialized. # pragma warning(disable : 28020) // Arithmetic overflow: Using operator '-' on a 4 byte value and then casting the result to a 8 byte value. # pragma warning(disable : 26451) // The expression '0<=_Param_(1)&&_Param_(1)<=1-1' is not true at this call. #endif // Checks magic_enum compiler compatibility. #if defined(__clang__) && __clang_major__ >= 5 || defined(__GNUC__) && __GNUC__ >= 9 || defined(_MSC_VER) && _MSC_VER >= 1910 # undef MAGIC_ENUM_SUPPORTED # define MAGIC_ENUM_SUPPORTED 1 #endif // Checks magic_enum compiler aliases compatibility. #if defined(__clang__) && __clang_major__ >= 5 || defined(__GNUC__) && __GNUC__ >= 9 || defined(_MSC_VER) && _MSC_VER >= 1920 # undef MAGIC_ENUM_SUPPORTED_ALIASES # define MAGIC_ENUM_SUPPORTED_ALIASES 1 #endif // Enum value must be greater or equals than MAGIC_ENUM_RANGE_MIN. By default MAGIC_ENUM_RANGE_MIN = -128. // If need another min range for all enum types by default, redefine the macro MAGIC_ENUM_RANGE_MIN. #if !defined(MAGIC_ENUM_RANGE_MIN) # define MAGIC_ENUM_RANGE_MIN -128 #endif // Enum value must be less or equals than MAGIC_ENUM_RANGE_MAX. By default MAGIC_ENUM_RANGE_MAX = 128. // If need another max range for all enum types by default, redefine the macro MAGIC_ENUM_RANGE_MAX. #if !defined(MAGIC_ENUM_RANGE_MAX) # define MAGIC_ENUM_RANGE_MAX 128 #endif namespace magic_enum { // If need another optional type, define the macro MAGIC_ENUM_USING_ALIAS_OPTIONAL. #if defined(MAGIC_ENUM_USING_ALIAS_OPTIONAL) MAGIC_ENUM_USING_ALIAS_OPTIONAL #else using std::optional; #endif // If need another string_view type, define the macro MAGIC_ENUM_USING_ALIAS_STRING_VIEW. #if defined(MAGIC_ENUM_USING_ALIAS_STRING_VIEW) MAGIC_ENUM_USING_ALIAS_STRING_VIEW #else using std::string_view; #endif // If need another string type, define the macro MAGIC_ENUM_USING_ALIAS_STRING. #if defined(MAGIC_ENUM_USING_ALIAS_STRING) MAGIC_ENUM_USING_ALIAS_STRING #else using std::string; #endif namespace customize { // Enum value must be in range [MAGIC_ENUM_RANGE_MIN, MAGIC_ENUM_RANGE_MAX]. By default MAGIC_ENUM_RANGE_MIN = -128, MAGIC_ENUM_RANGE_MAX = 128. // If need another range for all enum types by default, redefine the macro MAGIC_ENUM_RANGE_MIN and MAGIC_ENUM_RANGE_MAX. // If need another range for specific enum type, add specialization enum_range for necessary enum type. template struct enum_range { static_assert(std::is_enum_v, "magic_enum::customize::enum_range requires enum type."); inline static constexpr int min = MAGIC_ENUM_RANGE_MIN; inline static constexpr int max = MAGIC_ENUM_RANGE_MAX; static_assert(max > min, "magic_enum::customize::enum_range requires max > min."); }; static_assert(MAGIC_ENUM_RANGE_MIN <= 0, "MAGIC_ENUM_RANGE_MIN must be less or equals than 0."); static_assert(MAGIC_ENUM_RANGE_MIN > (std::numeric_limits::min)(), "MAGIC_ENUM_RANGE_MIN must be greater than INT16_MIN."); static_assert(MAGIC_ENUM_RANGE_MAX > 0, "MAGIC_ENUM_RANGE_MAX must be greater than 0."); static_assert(MAGIC_ENUM_RANGE_MAX < (std::numeric_limits::max)(), "MAGIC_ENUM_RANGE_MAX must be less than INT16_MAX."); static_assert(MAGIC_ENUM_RANGE_MAX > MAGIC_ENUM_RANGE_MIN, "MAGIC_ENUM_RANGE_MAX must be greater than MAGIC_ENUM_RANGE_MIN."); // If need custom names for enum, add specialization enum_name for necessary enum type. template constexpr string_view enum_name(E) noexcept { static_assert(std::is_enum_v, "magic_enum::customize::enum_name requires enum type."); return {}; } } // namespace magic_enum::customize namespace detail { template struct supported #if defined(MAGIC_ENUM_SUPPORTED) && MAGIC_ENUM_SUPPORTED || defined(MAGIC_ENUM_NO_CHECK_SUPPORT) : std::true_type {}; #else : std::false_type {}; #endif struct char_equal_to { constexpr bool operator()(char lhs, char rhs) const noexcept { return lhs == rhs; } }; template class static_string { public: constexpr explicit static_string(string_view str) noexcept : static_string{str, std::make_index_sequence{}} { assert(str.size() == N); } constexpr const char* data() const noexcept { return chars_; } constexpr std::size_t size() const noexcept { return N; } constexpr operator string_view() const noexcept { return {data(), size()}; } private: template constexpr static_string(string_view str, std::index_sequence) noexcept : chars_{str[I]..., '\0'} {} char chars_[N + 1]; }; template <> class static_string<0> { public: constexpr explicit static_string(string_view) noexcept {} constexpr const char* data() const noexcept { return nullptr; } constexpr std::size_t size() const noexcept { return 0; } constexpr operator string_view() const noexcept { return {}; } }; constexpr string_view pretty_name(string_view name) noexcept { for (std::size_t i = name.size(); i > 0; --i) { if (!((name[i - 1] >= '0' && name[i - 1] <= '9') || (name[i - 1] >= 'a' && name[i - 1] <= 'z') || (name[i - 1] >= 'A' && name[i - 1] <= 'Z') || (name[i - 1] == '_'))) { name.remove_prefix(i); break; } } if (name.size() > 0 && ((name.front() >= 'a' && name.front() <= 'z') || (name.front() >= 'A' && name.front() <= 'Z') || (name.front() == '_'))) { return name; } return {}; // Invalid name. } constexpr std::size_t find(string_view str, char c) noexcept { #if defined(__clang__) && __clang_major__ < 9 && defined(__GLIBCXX__) || defined(_MSC_VER) && _MSC_VER < 1920 && !defined(__clang__) // https://stackoverflow.com/questions/56484834/constexpr-stdstring-viewfind-last-of-doesnt-work-on-clang-8-with-libstdc // https://developercommunity.visualstudio.com/content/problem/360432/vs20178-regression-c-failed-in-test.html constexpr bool workaround = true; #else constexpr bool workaround = false; #endif if constexpr (workaround) { for (std::size_t i = 0; i < str.size(); ++i) { if (str[i] == c) { return i; } } return string_view::npos; } else { return str.find_first_of(c); } } template constexpr std::array, N> to_array(T (&a)[N], std::index_sequence) { return {{a[I]...}}; } template constexpr bool cmp_equal(string_view lhs, string_view rhs, BinaryPredicate&& p) noexcept(std::is_nothrow_invocable_r_v) { #if defined(_MSC_VER) && _MSC_VER < 1920 && !defined(__clang__) // https://developercommunity.visualstudio.com/content/problem/360432/vs20178-regression-c-failed-in-test.html // https://developercommunity.visualstudio.com/content/problem/232218/c-constexpr-string-view.html constexpr bool workaround = true; #else constexpr bool workaround = false; #endif constexpr bool default_predicate = std::is_same_v, char_equal_to>; if constexpr (default_predicate && !workaround) { static_cast(p); return lhs == rhs; } else { if (lhs.size() != rhs.size()) { return false; } const auto size = lhs.size(); for (std::size_t i = 0; i < size; ++i) { if (!p(lhs[i], rhs[i])) { return false; } } return true; } } template constexpr bool cmp_less(L lhs, R rhs) noexcept { static_assert(std::is_integral_v && std::is_integral_v, "magic_enum::detail::cmp_less requires integral type."); if constexpr (std::is_signed_v == std::is_signed_v) { // If same signedness (both signed or both unsigned). return lhs < rhs; } else if constexpr (std::is_signed_v) { // If 'right' is negative, then result is 'false', otherwise cast & compare. return rhs > 0 && lhs < static_cast>(rhs); } else { // If 'left' is negative, then result is 'true', otherwise cast & compare. return lhs < 0 || static_cast>(lhs) < rhs; } } template constexpr I log2(I value) noexcept { static_assert(std::is_integral_v, "magic_enum::detail::log2 requires integral type."); auto ret = I{0}; for (; value > I{1}; value >>= I{1}, ++ret) {} return ret; } template constexpr bool is_pow2(I x) noexcept { static_assert(std::is_integral_v, "magic_enum::detail::is_pow2 requires integral type."); return x != 0 && (x & (x - 1)) == 0; } template inline constexpr bool is_enum_v = std::is_enum_v && std::is_same_v>; template constexpr auto n() noexcept { static_assert(is_enum_v, "magic_enum::detail::n requires enum type."); #if defined(MAGIC_ENUM_SUPPORTED) && MAGIC_ENUM_SUPPORTED # if defined(__clang__) constexpr string_view name{__PRETTY_FUNCTION__ + 34, sizeof(__PRETTY_FUNCTION__) - 36}; # elif defined(__GNUC__) constexpr string_view name{__PRETTY_FUNCTION__ + 49, sizeof(__PRETTY_FUNCTION__) - 51}; # elif defined(_MSC_VER) constexpr string_view name{__FUNCSIG__ + 40, sizeof(__FUNCSIG__) - 57}; # endif return static_string{name}; #else return string_view{}; // Unsupported compiler. #endif } template inline constexpr auto type_name_v = n(); template constexpr auto n() noexcept { static_assert(is_enum_v, "magic_enum::detail::n requires enum type."); constexpr auto custom_name = customize::enum_name(V); if constexpr (custom_name.empty()) { static_cast(custom_name); #if defined(MAGIC_ENUM_SUPPORTED) && MAGIC_ENUM_SUPPORTED # if defined(__clang__) || defined(__GNUC__) constexpr auto name = pretty_name({__PRETTY_FUNCTION__, sizeof(__PRETTY_FUNCTION__) - 2}); # elif defined(_MSC_VER) constexpr auto name = pretty_name({__FUNCSIG__, sizeof(__FUNCSIG__) - 17}); # endif return static_string{name}; #else return string_view{}; // Unsupported compiler. #endif } else { return static_string{custom_name}; } } template inline constexpr auto enum_name_v = n(); template constexpr bool is_valid() noexcept { static_assert(is_enum_v, "magic_enum::detail::is_valid requires enum type."); return n(V)>().size() != 0; } template > constexpr E value(std::size_t i) noexcept { static_assert(is_enum_v, "magic_enum::detail::value requires enum type."); if constexpr (IsFlags) { return static_cast(U{1} << static_cast(static_cast(i) + O)); } else { return static_cast(static_cast(i) + O); } } template > constexpr int reflected_min() noexcept { static_assert(is_enum_v, "magic_enum::detail::reflected_min requires enum type."); if constexpr (IsFlags) { return 0; } else { constexpr auto lhs = customize::enum_range::min; static_assert(lhs > (std::numeric_limits::min)(), "magic_enum::enum_range requires min must be greater than INT16_MIN."); constexpr auto rhs = (std::numeric_limits::min)(); if constexpr (cmp_less(lhs, rhs)) { return rhs; } else { static_assert(!is_valid(0)>(), "magic_enum::enum_range detects enum value smaller than min range size."); return lhs; } } } template > constexpr int reflected_max() noexcept { static_assert(is_enum_v, "magic_enum::detail::reflected_max requires enum type."); if constexpr (IsFlags) { return std::numeric_limits::digits - 1; } else { constexpr auto lhs = customize::enum_range::max; static_assert(lhs < (std::numeric_limits::max)(), "magic_enum::enum_range requires max must be less than INT16_MAX."); constexpr auto rhs = (std::numeric_limits::max)(); if constexpr (cmp_less(lhs, rhs)) { static_assert(!is_valid(0)>(), "magic_enum::enum_range detects enum value larger than max range size."); return lhs; } else { return rhs; } } } template inline constexpr auto reflected_min_v = reflected_min(); template inline constexpr auto reflected_max_v = reflected_max(); template constexpr std::size_t values_count(const bool (&valid)[N]) noexcept { auto count = std::size_t{0}; for (std::size_t i = 0; i < N; ++i) { if (valid[i]) { ++count; } } return count; } template constexpr auto values(std::index_sequence) noexcept { static_assert(is_enum_v, "magic_enum::detail::values requires enum type."); constexpr bool valid[sizeof...(I)] = {is_valid(I)>()...}; constexpr std::size_t count = values_count(valid); if constexpr (count > 0) { E values[count] = {}; for (std::size_t i = 0, v = 0; v < count; ++i) { if (valid[i]) { values[v++] = value(i); } } return to_array(values, std::make_index_sequence{}); } else { return std::array{}; } } template > constexpr auto values() noexcept { static_assert(is_enum_v, "magic_enum::detail::values requires enum type."); constexpr auto min = reflected_min_v; constexpr auto max = reflected_max_v; constexpr auto range_size = max - min + 1; static_assert(range_size > 0, "magic_enum::enum_range requires valid size."); static_assert(range_size < (std::numeric_limits::max)(), "magic_enum::enum_range requires valid size."); return values>(std::make_index_sequence{}); } template inline constexpr auto values_v = values(); template > using values_t = decltype((values_v)); template inline constexpr auto count_v = values_v.size(); template > inline constexpr auto min_v = (count_v > 0) ? static_cast(values_v.front()) : U{0}; template > inline constexpr auto max_v = (count_v > 0) ? static_cast(values_v.back()) : U{0}; template > constexpr std::size_t range_size() noexcept { static_assert(is_enum_v, "magic_enum::detail::range_size requires enum type."); constexpr auto max = IsFlags ? log2(max_v) : max_v; constexpr auto min = IsFlags ? log2(min_v) : min_v; constexpr auto range_size = max - min + U{1}; static_assert(range_size > 0, "magic_enum::enum_range requires valid size."); static_assert(range_size < (std::numeric_limits::max)(), "magic_enum::enum_range requires valid size."); return static_cast(range_size); } template inline constexpr auto range_size_v = range_size(); template using index_t = std::conditional_t < (std::numeric_limits::max)(), std::uint8_t, std::uint16_t>; template inline constexpr auto invalid_index_v = (std::numeric_limits>::max)(); template constexpr auto indexes(std::index_sequence) noexcept { static_assert(is_enum_v, "magic_enum::detail::indexes requires enum type."); constexpr auto min = IsFlags ? log2(min_v) : min_v; [[maybe_unused]] auto i = index_t{0}; return std::array{{(is_valid(I)>() ? i++ : invalid_index_v)...}}; } template inline constexpr auto indexes_v = indexes(std::make_index_sequence>{}); template constexpr auto names(std::index_sequence) noexcept { static_assert(is_enum_v, "magic_enum::detail::names requires enum type."); return std::array{{enum_name_v[I]>...}}; } template inline constexpr auto names_v = names(std::make_index_sequence>{}); template > using names_t = decltype((names_v)); template constexpr auto entries(std::index_sequence) noexcept { static_assert(is_enum_v, "magic_enum::detail::entries requires enum type."); return std::array, sizeof...(I)>{{{values_v[I], enum_name_v[I]>}...}}; } template inline constexpr auto entries_v = entries(std::make_index_sequence>{}); template > using entries_t = decltype((entries_v)); template > constexpr bool is_sparse() noexcept { static_assert(is_enum_v, "magic_enum::detail::is_sparse requires enum type."); return range_size_v != count_v; } template inline constexpr bool is_sparse_v = is_sparse(); template > constexpr std::size_t undex(U value) noexcept { static_assert(is_enum_v, "magic_enum::detail::undex requires enum type."); if (const auto i = static_cast(value - min_v); value >= min_v && value <= max_v) { if constexpr (is_sparse_v) { if (const auto idx = indexes_v[i]; idx != invalid_index_v) { return idx; } } else { return i; } } return invalid_index_v; // Value out of range. } template > constexpr std::size_t endex(E value) noexcept { static_assert(is_enum_v, "magic_enum::detail::endex requires enum type."); return undex(static_cast(value)); } template > constexpr U value_ors() noexcept { static_assert(is_enum_v, "magic_enum::detail::endex requires enum type."); auto value = U{0}; for (std::size_t i = 0; i < count_v; ++i) { value |= static_cast(values_v[i]); } return value; } template struct enable_if_enum {}; template struct enable_if_enum { using type = R; using D = std::decay_t; static_assert(supported::value, "magic_enum unsupported compiler (https://github.com/Neargye/magic_enum#compiler-compatibility)."); }; template using enable_if_enum_t = std::enable_if_t>, R>; template >>> using enum_concept = T; template > struct is_scoped_enum : std::false_type {}; template struct is_scoped_enum : std::bool_constant>> {}; template > struct is_unscoped_enum : std::false_type {}; template struct is_unscoped_enum : std::bool_constant>> {}; template >> struct underlying_type {}; template struct underlying_type : std::underlying_type> {}; } // namespace magic_enum::detail // Checks is magic_enum supported compiler. inline constexpr bool is_magic_enum_supported = detail::supported::value; template using Enum = detail::enum_concept; // Checks whether T is an Unscoped enumeration type. // Provides the member constant value which is equal to true, if T is an [Unscoped enumeration](https://en.cppreference.com/w/cpp/language/enum#Unscoped_enumeration) type. Otherwise, value is equal to false. template struct is_unscoped_enum : detail::is_unscoped_enum {}; template inline constexpr bool is_unscoped_enum_v = is_unscoped_enum::value; // Checks whether T is an Scoped enumeration type. // Provides the member constant value which is equal to true, if T is an [Scoped enumeration](https://en.cppreference.com/w/cpp/language/enum#Scoped_enumerations) type. Otherwise, value is equal to false. template struct is_scoped_enum : detail::is_scoped_enum {}; template inline constexpr bool is_scoped_enum_v = is_scoped_enum::value; // If T is a complete enumeration type, provides a member typedef type that names the underlying type of T. // Otherwise, if T is not an enumeration type, there is no member type. Otherwise (T is an incomplete enumeration type), the program is ill-formed. template struct underlying_type : detail::underlying_type {}; template using underlying_type_t = typename underlying_type::type; // Returns type name of enum. template [[nodiscard]] constexpr auto enum_type_name() noexcept -> detail::enable_if_enum_t { using D = std::decay_t; constexpr string_view name = detail::type_name_v; static_assert(name.size() > 0, "Enum type does not have a name."); return name; } // Returns number of enum values. template [[nodiscard]] constexpr auto enum_count() noexcept -> detail::enable_if_enum_t { using D = std::decay_t; return detail::count_v; } // Returns enum value at specified index. // No bounds checking is performed: the behavior is undefined if index >= number of enum values. template [[nodiscard]] constexpr auto enum_value(std::size_t index) noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum requires enum implementation and valid max and min."); if constexpr (detail::is_sparse_v) { return assert((index < detail::count_v)), detail::values_v[index]; } else { return assert((index < detail::count_v)), detail::value>(index); } } // Returns std::array with enum values, sorted by enum value. template [[nodiscard]] constexpr auto enum_values() noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum requires enum implementation and valid max and min."); return detail::values_v; } // Returns name from static storage enum variable. // This version is much lighter on the compile times and is not restricted to the enum_range limitation. template [[nodiscard]] constexpr auto enum_name() noexcept -> detail::enable_if_enum_t { using D = std::decay_t; constexpr string_view name = detail::enum_name_v; static_assert(name.size() > 0, "Enum value does not have a name."); return name; } // Returns name from enum value. // If enum value does not have name or value out of range, returns empty string. template [[nodiscard]] constexpr auto enum_name(E value) noexcept -> detail::enable_if_enum_t { using D = std::decay_t; if (const auto i = detail::endex(value); i != detail::invalid_index_v) { return detail::names_v[i]; } return {}; // Invalid value or out of range. } // Returns std::array with names, sorted by enum value. template [[nodiscard]] constexpr auto enum_names() noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum requires enum implementation and valid max and min."); return detail::names_v; } // Returns std::array with pairs (value, name), sorted by enum value. template [[nodiscard]] constexpr auto enum_entries() noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum requires enum implementation and valid max and min."); return detail::entries_v; } // Obtains enum value from integer value. // Returns optional with enum value. template [[nodiscard]] constexpr auto enum_cast(underlying_type_t value) noexcept -> detail::enable_if_enum_t>> { using D = std::decay_t; if (detail::undex(value) != detail::invalid_index_v) { return static_cast(value); } return {}; // Invalid value or out of range. } // Obtains enum value from name. // Returns optional with enum value. template [[nodiscard]] constexpr auto enum_cast(string_view value, BinaryPredicate p) noexcept(std::is_nothrow_invocable_r_v) -> detail::enable_if_enum_t>> { static_assert(std::is_invocable_r_v, "magic_enum::enum_cast requires bool(char, char) invocable predicate."); using D = std::decay_t; for (std::size_t i = 0; i < detail::count_v; ++i) { if (detail::cmp_equal(value, detail::names_v[i], p)) { return enum_value(i); } } return {}; // Invalid value or out of range. } // Obtains enum value from name. // Returns optional with enum value. template [[nodiscard]] constexpr auto enum_cast(string_view value) noexcept -> detail::enable_if_enum_t>> { using D = std::decay_t; return enum_cast(value, detail::char_equal_to{}); } // Returns integer value from enum value. template [[nodiscard]] constexpr auto enum_integer(E value) noexcept -> detail::enable_if_enum_t> { return static_cast>(value); } // Obtains index in enum values from enum value. // Returns optional with index. template [[nodiscard]] constexpr auto enum_index(E value) noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; if (const auto i = detail::endex(value); i != detail::invalid_index_v) { return i; } return {}; // Invalid value or out of range. } // Checks whether enum contains enumerator with such enum value. template [[nodiscard]] constexpr auto enum_contains(E value) noexcept -> detail::enable_if_enum_t { using D = std::decay_t; return detail::endex(value) != detail::invalid_index_v; } // Checks whether enum contains enumerator with such integer value. template [[nodiscard]] constexpr auto enum_contains(underlying_type_t value) noexcept -> detail::enable_if_enum_t { using D = std::decay_t; return detail::undex(value) != detail::invalid_index_v; } // Checks whether enum contains enumerator with such name. template [[nodiscard]] constexpr auto enum_contains(string_view value, BinaryPredicate p) noexcept(std::is_nothrow_invocable_r_v) -> detail::enable_if_enum_t { static_assert(std::is_invocable_r_v, "magic_enum::enum_contains requires bool(char, char) invocable predicate."); using D = std::decay_t; return enum_cast(value, std::move_if_noexcept(p)).has_value(); } // Checks whether enum contains enumerator with such name. template [[nodiscard]] constexpr auto enum_contains(string_view value) noexcept -> detail::enable_if_enum_t { using D = std::decay_t; return enum_cast(value).has_value(); } namespace ostream_operators { template , int> = 0> std::basic_ostream& operator<<(std::basic_ostream& os, E value) { using D = std::decay_t; using U = underlying_type_t; #if defined(MAGIC_ENUM_SUPPORTED) && MAGIC_ENUM_SUPPORTED if (const auto name = magic_enum::enum_name(value); !name.empty()) { for (const auto c : name) { os.put(c); } return os; } #endif return (os << static_cast(value)); } template , int> = 0> std::basic_ostream& operator<<(std::basic_ostream& os, optional value) { return value.has_value() ? (os << value.value()) : os; } } // namespace magic_enum::ostream_operators namespace bitwise_operators { template , int> = 0> constexpr E operator~(E rhs) noexcept { return static_cast(~static_cast>(rhs)); } template , int> = 0> constexpr E operator|(E lhs, E rhs) noexcept { return static_cast(static_cast>(lhs) | static_cast>(rhs)); } template , int> = 0> constexpr E operator&(E lhs, E rhs) noexcept { return static_cast(static_cast>(lhs) & static_cast>(rhs)); } template , int> = 0> constexpr E operator^(E lhs, E rhs) noexcept { return static_cast(static_cast>(lhs) ^ static_cast>(rhs)); } template , int> = 0> constexpr E& operator|=(E& lhs, E rhs) noexcept { return lhs = (lhs | rhs); } template , int> = 0> constexpr E& operator&=(E& lhs, E rhs) noexcept { return lhs = (lhs & rhs); } template , int> = 0> constexpr E& operator^=(E& lhs, E rhs) noexcept { return lhs = (lhs ^ rhs); } } // namespace magic_enum::bitwise_operators namespace flags { // Returns type name of enum. using magic_enum::enum_type_name; // Returns number of enum-flags values. template [[nodiscard]] constexpr auto enum_count() noexcept -> detail::enable_if_enum_t { using D = std::decay_t; return detail::count_v; } // Returns enum-flags value at specified index. // No bounds checking is performed: the behavior is undefined if index >= number of enum-flags values. template [[nodiscard]] constexpr auto enum_value(std::size_t index) noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum::flags requires enum-flags implementation."); if constexpr (detail::is_sparse_v) { return assert((index < detail::count_v)), detail::values_v[index]; } else { constexpr auto min = detail::log2(detail::min_v); return assert((index < detail::count_v)), detail::value(index); } } // Returns std::array with enum-flags values, sorted by enum-flags value. template [[nodiscard]] constexpr auto enum_values() noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum::flags requires enum-flags implementation."); return detail::values_v; } // Returns name from enum-flags value. // If enum-flags value does not have name or value out of range, returns empty string. template [[nodiscard]] auto enum_name(E value) -> detail::enable_if_enum_t { using D = std::decay_t; using U = underlying_type_t; string name; auto check_value = U{0}; for (std::size_t i = 0; i < detail::count_v; ++i) { if (const auto v = static_cast(enum_value(i)); (static_cast(value) & v) != 0) { check_value |= v; const auto n = detail::names_v[i]; if (!name.empty()) { name.append(1, '|'); } name.append(n.data(), n.size()); } } if (check_value != 0 && check_value == static_cast(value)) { return name; } return {}; // Invalid value or out of range. } // Returns std::array with string names, sorted by enum-flags value. template [[nodiscard]] constexpr auto enum_names() noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum::flags requires enum-flags implementation."); return detail::names_v; } // Returns std::array with pairs (value, name), sorted by enum-flags value. template [[nodiscard]] constexpr auto enum_entries() noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; static_assert(detail::count_v > 0, "magic_enum::flags requires enum-flags implementation."); return detail::entries_v; } // Obtains enum-flags value from integer value. // Returns optional with enum-flags value. template [[nodiscard]] constexpr auto enum_cast(underlying_type_t value) noexcept -> detail::enable_if_enum_t>> { using D = std::decay_t; using U = underlying_type_t; if constexpr (detail::is_sparse_v) { auto check_value = U{0}; for (std::size_t i = 0; i < detail::count_v; ++i) { if (const auto v = static_cast(enum_value(i)); (value & v) != 0) { check_value |= v; } } if (check_value != 0 && check_value == value) { return static_cast(value); } } else { constexpr auto min = detail::min_v; constexpr auto max = detail::value_ors(); if (value >= min && value <= max) { return static_cast(value); } } return {}; // Invalid value or out of range. } // Obtains enum-flags value from name. // Returns optional with enum-flags value. template [[nodiscard]] constexpr auto enum_cast(string_view value, BinaryPredicate p) noexcept(std::is_nothrow_invocable_r_v) -> detail::enable_if_enum_t>> { static_assert(std::is_invocable_r_v, "magic_enum::flags::enum_cast requires bool(char, char) invocable predicate."); using D = std::decay_t; using U = underlying_type_t; auto result = U{0}; while (!value.empty()) { const auto d = detail::find(value, '|'); const auto s = (d == string_view::npos) ? value : value.substr(0, d); auto f = U{0}; for (std::size_t i = 0; i < detail::count_v; ++i) { if (detail::cmp_equal(s, detail::names_v[i], p)) { f = static_cast(enum_value(i)); result |= f; break; } } if (f == U{0}) { return {}; // Invalid value or out of range. } value.remove_prefix((d == string_view::npos) ? value.size() : d + 1); } if (result == U{0}) { return {}; // Invalid value or out of range. } else { return static_cast(result); } } // Obtains enum-flags value from name. // Returns optional with enum-flags value. template [[nodiscard]] constexpr auto enum_cast(string_view value) noexcept -> detail::enable_if_enum_t>> { using D = std::decay_t; return enum_cast(value, detail::char_equal_to{}); } // Returns integer value from enum value. using magic_enum::enum_integer; // Obtains index in enum-flags values from enum-flags value. // Returns optional with index. template [[nodiscard]] constexpr auto enum_index(E value) noexcept -> detail::enable_if_enum_t> { using D = std::decay_t; using U = underlying_type_t; if (detail::is_pow2(static_cast(value))) { for (std::size_t i = 0; i < detail::count_v; ++i) { if (enum_value(i) == value) { return i; } } } return {}; // Invalid value or out of range. } // Checks whether enum-flags contains enumerator with such enum-flags value. template [[nodiscard]] constexpr auto enum_contains(E value) noexcept -> detail::enable_if_enum_t { using D = std::decay_t; using U = underlying_type_t; return enum_cast(static_cast(value)).has_value(); } // Checks whether enum-flags contains enumerator with such integer value. template [[nodiscard]] constexpr auto enum_contains(underlying_type_t value) noexcept -> detail::enable_if_enum_t { using D = std::decay_t; return enum_cast(value).has_value(); } // Checks whether enum-flags contains enumerator with such name. template [[nodiscard]] constexpr auto enum_contains(string_view value, BinaryPredicate p) noexcept(std::is_nothrow_invocable_r_v) -> detail::enable_if_enum_t { static_assert(std::is_invocable_r_v, "magic_enum::flags::enum_contains requires bool(char, char) invocable predicate."); using D = std::decay_t; return enum_cast(value, std::move_if_noexcept(p)).has_value(); } // Checks whether enum-flags contains enumerator with such name. template [[nodiscard]] constexpr auto enum_contains(string_view value) noexcept -> detail::enable_if_enum_t { using D = std::decay_t; return enum_cast(value).has_value(); } } // namespace magic_enum::flags namespace flags::ostream_operators { template , int> = 0> std::basic_ostream& operator<<(std::basic_ostream& os, E value) { using D = std::decay_t; using U = underlying_type_t; #if defined(MAGIC_ENUM_SUPPORTED) && MAGIC_ENUM_SUPPORTED if (const auto name = magic_enum::flags::enum_name(value); !name.empty()) { for (const auto c : name) { os.put(c); } return os; } #endif return (os << static_cast(value)); } template , int> = 0> std::basic_ostream& operator<<(std::basic_ostream& os, optional value) { return value.has_value() ? (os << value.value()) : os; } } // namespace magic_enum::flags::ostream_operators namespace flags::bitwise_operators { using namespace magic_enum::bitwise_operators; } // namespace magic_enum::flags::bitwise_operators } // namespace magic_enum #if defined(__clang__) # pragma clang diagnostic pop #elif defined(__GNUC__) # pragma GCC diagnostic pop #elif defined(_MSC_VER) # pragma warning(pop) #endif #endif // NEARGYE_MAGIC_ENUM_HPP