#pragma once // C++ #include #include #include #include #include #include #include #include #include #include #include #include "BitStream.h" #include "NiPoint3.h" #include "dPlatforms.h" #include "Game.h" #include "Logger.h" enum eInventoryType : uint32_t; enum class eObjectBits : size_t; enum class eReplicaComponentType : uint32_t; /*! \file GeneralUtils.hpp \brief A namespace containing general utility functions */ //! The general utils namespace namespace GeneralUtils { //! Converts a plain ASCII string to a UTF-16 string /*! \param string The string to convert \param size A size to trim the string to. Default is SIZE_MAX (No trimming) \return An UTF-16 representation of the string */ std::u16string ASCIIToUTF16(const std::string_view string, const size_t size = SIZE_MAX); //! Converts a UTF-8 String to a UTF-16 string /*! \param string The string to convert \param size A size to trim the string to. Default is SIZE_MAX (No trimming) \return An UTF-16 representation of the string */ std::u16string UTF8ToUTF16(const std::string_view string, const size_t size = SIZE_MAX); namespace details { //! Internal, do not use bool _NextUTF8Char(std::string_view& slice, uint32_t& out); } //! Converts a UTF-16 string to a UTF-8 string /*! \param string The string to convert \param size A size to trim the string to. Default is SIZE_MAX (No trimming) \return An UTF-8 representation of the string */ std::string UTF16ToWTF8(const std::u16string_view string, const size_t size = SIZE_MAX); /** * Compares two basic strings but does so ignoring case sensitivity * \param a the first string to compare against the second string * \param b the second string to compare against the first string * @return if the two strings are equal */ bool CaseInsensitiveStringCompare(const std::string_view a, const std::string_view b); // MARK: Bits // MARK: Bits //! Sets a bit on a numerical value template inline void SetBit(T& value, const eObjectBits bits) { static_assert(std::is_arithmetic::value, "Not an arithmetic type"); const auto index = static_cast(bits); if (index > (sizeof(T) * 8) - 1) { return; } value |= static_cast(1) << index; } //! Clears a bit on a numerical value template inline void ClearBit(T& value, const eObjectBits bits) { static_assert(std::is_arithmetic::value, "Not an arithmetic type"); const auto index = static_cast(bits); if (index > (sizeof(T) * 8 - 1)) { return; } value &= ~(static_cast(1) << index); } //! Sets a specific bit in a signed 64-bit integer /*! \param value The value to set the bit for \param index The index of the bit */ int64_t SetBit(int64_t value, const uint32_t index); //! Clears a specific bit in a signed 64-bit integer /*! \param value The value to clear the bit from \param index The index of the bit */ int64_t ClearBit(int64_t value, const uint32_t index); //! Checks a specific bit in a signed 64-bit integer /*! \parma value The value to check the bit in \param index The index of the bit \return Whether or not the bit is set */ bool CheckBit(int64_t value, const uint32_t index); bool ReplaceInString(std::string& str, const std::string_view from, const std::string_view to); std::u16string ReadWString(RakNet::BitStream& inStream); std::vector SplitString(const std::wstring_view str, const wchar_t delimiter); std::vector SplitString(const std::u16string_view str, const char16_t delimiter); std::vector SplitString(const std::string_view str, const char delimiter); std::vector GetSqlFileNamesFromFolder(const std::string_view folder); // Concept constraining to enum types template concept Enum = std::is_enum_v; // Concept constraining to numeric types template concept Numeric = std::integral || Enum || std::floating_point; // Concept trickery to enable parsing underlying numeric types template struct numeric_parse { using type = T; }; // If an enum, present an alias to its underlying type for parsing template requires Enum struct numeric_parse { using type = std::underlying_type_t; }; // If a boolean, present an alias to an intermediate integral type for parsing template requires std::same_as struct numeric_parse { using type = uint8_t; }; // Shorthand type alias template using numeric_parse_t = numeric_parse::type; /** * For numeric values: Parses a string_view and returns an optional variable depending on the result. * @param str The string_view to be evaluated * @returns An std::optional containing the desired value if it is equivalent to the string */ template [[nodiscard]] std::optional TryParse(std::string_view str) { numeric_parse_t result; while (!str.empty() && std::isspace(str.front())) str.remove_prefix(1); const char* const strEnd = str.data() + str.size(); const auto [parseEnd, ec] = std::from_chars(str.data(), strEnd, result); const bool isParsed = parseEnd == strEnd && ec == std::errc{}; return isParsed ? static_cast(result) : std::optional{}; } #if !(__GNUC__ >= 11 || _MSC_VER >= 1924) // MacOS floating-point parse helper function specializations namespace details { template [[nodiscard]] T _parse(const std::string_view str, size_t& parseNum); } /** * For floating-point values: Parses a string_view and returns an optional variable depending on the result. * Note that this function overload is only included for MacOS, as from_chars will fulfill its purpose otherwise. * @param str The string_view to be evaluated * @returns An std::optional containing the desired value if it is equivalent to the string */ template [[nodiscard]] std::optional TryParse(std::string_view str) noexcept try { while (!str.empty() && std::isspace(str.front())) str.remove_prefix(1); size_t parseNum; const T result = details::_parse(str, parseNum); const bool isParsed = str.length() == parseNum; return isParsed ? result : std::optional{}; } catch (...) { return std::nullopt; } #endif /** * The TryParse overload for handling NiPoint3 by passing 3 seperate string references * @param strX The string representing the X coordinate * @param strY The string representing the Y coordinate * @param strZ The string representing the Z coordinate * @returns An std::optional containing the desired NiPoint3 if it can be constructed from the string parameters */ template [[nodiscard]] std::optional TryParse(const std::string_view strX, const std::string_view strY, const std::string_view strZ) { const auto x = TryParse(strX); if (!x) return std::nullopt; const auto y = TryParse(strY); if (!y) return std::nullopt; const auto z = TryParse(strZ); return z ? std::make_optional(x.value(), y.value(), z.value()) : std::nullopt; } /** * The TryParse overload for handling NiPoint3 by passing a span of three strings * @param str The string vector representing the X, Y, and Z coordinates * @returns An std::optional containing the desired NiPoint3 if it can be constructed from the string parameters */ template [[nodiscard]] std::optional TryParse(const std::span str) { return (str.size() == 3) ? TryParse(str[0], str[1], str[2]) : std::nullopt; } template std::u16string to_u16string(const T value) { return GeneralUtils::ASCIIToUTF16(std::to_string(value)); } // From boost::hash_combine template constexpr void hash_combine(std::size_t& s, const T& v) { std::hash h; s ^= h(v) + 0x9e3779b9 + (s << 6) + (s >> 2); } // MARK: Random Number Generation //! Generates a random number /*! \param min The minimum the generate from \param max The maximum to generate to */ template inline T GenerateRandomNumber(const std::size_t min, const std::size_t max) { // Make sure it is a numeric type static_assert(std::is_arithmetic::value, "Not an arithmetic type"); if constexpr (std::is_integral_v) { // constexpr only necessary on first statement std::uniform_int_distribution distribution(min, max); return distribution(Game::randomEngine); } else if (std::is_floating_point_v) { std::uniform_real_distribution distribution(min, max); return distribution(Game::randomEngine); } return T(); } /** * Casts the value of an enum entry to its underlying type * @param entry Enum entry to cast * @returns The enum entry's value in its underlying type */ template constexpr std::underlying_type_t ToUnderlying(const eType entry) noexcept { return static_cast>(entry); } // on Windows we need to undef these or else they conflict with our numeric limits calls // DEVELOPERS DEVELOPERS DEVELOPERS DEVELOPERS DEVELOPERS DEVELOPERS DEVELOPERS DEVELOPERS #ifdef _WIN32 #undef min #undef max #endif template inline T GenerateRandomNumber() { // Make sure it is a numeric type static_assert(std::is_arithmetic::value, "Not an arithmetic type"); return GenerateRandomNumber(std::numeric_limits::min(), std::numeric_limits::max()); } }