#pragma once #include "CoreTypes.h" #include "Templates/Meta.h" #include "Templates/Utility.h" #include "Templates/TypeHash.h" #include "Templates/Container.h" #include "Containers/Iterator.h" #include "TypeTraits/TypeTraits.h" #include "Miscellaneous/Compare.h" #include "Memory/ObserverPointer.h" #include "Miscellaneous/AssertionMacros.h" NAMESPACE_REDCRAFT_BEGIN NAMESPACE_MODULE_BEGIN(Redcraft) NAMESPACE_MODULE_BEGIN(Utility) NAMESPACE_PRIVATE_BEGIN template class TStaticArrayIterator { public: using ElementType = T; FORCEINLINE constexpr TStaticArrayIterator() = default; # if DO_CHECK FORCEINLINE constexpr TStaticArrayIterator(const TStaticArrayIterator>& InValue) requires (CConst) : Owner(InValue.Owner), Pointer(InValue.Pointer) { } # else FORCEINLINE constexpr TStaticArrayIterator(const TStaticArrayIterator>& InValue) requires (CConst) : Pointer(InValue.Pointer) { } # endif FORCEINLINE constexpr TStaticArrayIterator(const TStaticArrayIterator&) = default; FORCEINLINE constexpr TStaticArrayIterator(TStaticArrayIterator&&) = default; FORCEINLINE constexpr TStaticArrayIterator& operator=(const TStaticArrayIterator&) = default; FORCEINLINE constexpr TStaticArrayIterator& operator=(TStaticArrayIterator&&) = default; NODISCARD friend FORCEINLINE constexpr bool operator==(const TStaticArrayIterator& LHS, const TStaticArrayIterator& RHS) { return LHS.Pointer == RHS.Pointer; } NODISCARD friend FORCEINLINE constexpr strong_ordering operator<=>(const TStaticArrayIterator & LHS, const TStaticArrayIterator & RHS) { return LHS.Pointer <=> RHS.Pointer; } NODISCARD FORCEINLINE constexpr ElementType& operator*() const { CheckThis(true); return *Pointer; } NODISCARD FORCEINLINE constexpr ElementType* operator->() const { CheckThis(true); return Pointer; } NODISCARD FORCEINLINE constexpr ElementType& operator[](ptrdiff Index) const { TStaticArrayIterator Temp = *this + Index; return *Temp; } FORCEINLINE constexpr TStaticArrayIterator& operator++() { ++Pointer; CheckThis(); return *this; } FORCEINLINE constexpr TStaticArrayIterator& operator--() { --Pointer; CheckThis(); return *this; } FORCEINLINE constexpr TStaticArrayIterator operator++(int) { TStaticArrayIterator Temp = *this; ++Pointer; CheckThis(); return Temp; } FORCEINLINE constexpr TStaticArrayIterator operator--(int) { TStaticArrayIterator Temp = *this; --Pointer; CheckThis(); return Temp; } FORCEINLINE constexpr TStaticArrayIterator& operator+=(ptrdiff Offset) { Pointer += Offset; CheckThis(); return *this; } FORCEINLINE constexpr TStaticArrayIterator& operator-=(ptrdiff Offset) { Pointer -= Offset; CheckThis(); return *this; } NODISCARD friend FORCEINLINE constexpr TStaticArrayIterator operator+(TStaticArrayIterator Iter, ptrdiff Offset) { TStaticArrayIterator Temp = Iter; Temp += Offset; return Temp; } NODISCARD friend FORCEINLINE constexpr TStaticArrayIterator operator+(ptrdiff Offset, TStaticArrayIterator Iter) { TStaticArrayIterator Temp = Iter; Temp += Offset; return Temp; } NODISCARD FORCEINLINE constexpr TStaticArrayIterator operator-(ptrdiff Offset) const { TStaticArrayIterator Temp = *this; Temp -= Offset; return Temp; } NODISCARD friend FORCEINLINE constexpr ptrdiff operator-(const TStaticArrayIterator& LHS, const TStaticArrayIterator& RHS) { LHS.CheckThis(); RHS.CheckThis(); return LHS.Pointer - RHS.Pointer; } NODISCARD FORCEINLINE constexpr explicit operator ElementType*() requires (!CConst) { CheckThis(); return Pointer; } NODISCARD FORCEINLINE constexpr explicit operator const ElementType*() const { CheckThis(); return Pointer; } private: # if DO_CHECK const ArrayType* Owner = nullptr; # endif ElementType* Pointer = nullptr; # if DO_CHECK FORCEINLINE constexpr TStaticArrayIterator(const ArrayType* InContainer, ElementType* InPointer) : Owner(InContainer), Pointer(InPointer) { } # else FORCEINLINE constexpr TStaticArrayIterator(const ArrayType* InContainer, ElementType* InPointer) : Pointer(InPointer) { } # endif FORCEINLINE constexpr void CheckThis(bool bExceptEnd = false) const { checkf(Owner && Owner->IsValidIterator(*this), TEXT("Read access violation. Please check IsValidIterator().")); checkf(!(bExceptEnd && Owner->End() == *this), TEXT("Read access violation. Please check IsValidIterator().")); } friend ArrayType; template friend class TStaticArrayIterator; }; NAMESPACE_PRIVATE_END /** TStaticArray is a container that encapsulates fixed size arrays. */ template struct TStaticArray final { using ElementType = T; using Iterator = NAMESPACE_PRIVATE::TStaticArrayIterator; using ConstIterator = NAMESPACE_PRIVATE::TStaticArrayIterator; using ReverseIterator = TReverseIterator< Iterator>; using ConstReverseIterator = TReverseIterator; static_assert(CContiguousIterator< Iterator>); static_assert(CContiguousIterator); /** Compares the contents of two arrays. */ NODISCARD friend constexpr bool operator==(const TStaticArray& LHS, const TStaticArray& RHS) requires (CWeaklyEqualityComparable) { if (LHS.Num() != RHS.Num()) return false; ConstIterator LHSIter = LHS.Begin(); ConstIterator RHSIter = RHS.Begin(); while (LHSIter != LHS.End()) { if (*LHSIter != *RHSIter) return false; ++LHSIter; ++RHSIter; } check(RHSIter == RHS.End()); return true; } /** Compares the contents of two arrays. */ NODISCARD friend constexpr auto operator<=>(const TStaticArray& LHS, const TStaticArray& RHS) requires (CSynthThreeWayComparable) { using OrderingType = TSynthThreeWayResult; if (LHS.Num() < RHS.Num()) return OrderingType::less; if (LHS.Num() > RHS.Num()) return OrderingType::greater; ConstIterator LHSIter = LHS.Begin(); ConstIterator RHSIter = RHS.Begin(); while (LHSIter != LHS.End()) { TSynthThreeWayResult Ordering = SynthThreeWayCompare(*LHSIter, *RHSIter); if (Ordering != OrderingType::equivalent) return Ordering; ++LHSIter; ++RHSIter; } check(RHSIter == RHS.End()); return OrderingType::equivalent; } /** @return The pointer to the underlying element storage. */ NODISCARD FORCEINLINE constexpr TObserverPtr< ElementType[]> GetData() { return TObserverPtr< ElementType[]>(_); } NODISCARD FORCEINLINE constexpr TObserverPtr GetData() const { return TObserverPtr(_); } /** @return The iterator to the first or end element. */ NODISCARD FORCEINLINE constexpr Iterator Begin() { return Iterator(this, _); } NODISCARD FORCEINLINE constexpr ConstIterator Begin() const { return ConstIterator(this, _); } NODISCARD FORCEINLINE constexpr Iterator End() { return Iterator(this, _ + Num()); } NODISCARD FORCEINLINE constexpr ConstIterator End() const { return ConstIterator(this, _ + Num()); } /** @return The reverse iterator to the first or end element. */ NODISCARD FORCEINLINE constexpr ReverseIterator RBegin() { return ReverseIterator(End()); } NODISCARD FORCEINLINE constexpr ConstReverseIterator RBegin() const { return ConstReverseIterator(End()); } NODISCARD FORCEINLINE constexpr ReverseIterator REnd() { return ReverseIterator(Begin()); } NODISCARD FORCEINLINE constexpr ConstReverseIterator REnd() const { return ConstReverseIterator(Begin()); } /** @return The number of elements in the container. */ NODISCARD FORCEINLINE constexpr size_t Num() const { return N; } NODISCARD FORCEINLINE constexpr size_t Max() const { return N; } /** @return true if the container is empty, false otherwise. */ NODISCARD FORCEINLINE constexpr bool IsEmpty() const { return Num() == 0; } /** @return true if the iterator is valid, false otherwise. */ NODISCARD FORCEINLINE constexpr bool IsValidIterator(ConstIterator Iter) const { return Begin() <= Iter && Iter <= End(); } /** @return The reference to the requested element. */ NODISCARD FORCEINLINE constexpr ElementType& operator[](size_t Index) { checkf(Index < Num(), TEXT("Read access violation. Please check IsValidIterator().")); return _[Index]; } NODISCARD FORCEINLINE constexpr const ElementType& operator[](size_t Index) const { checkf(Index < Num(), TEXT("Read access violation. Please check IsValidIterator().")); return _[Index]; } /** @return The reference to the first or last element. */ NODISCARD FORCEINLINE constexpr ElementType& Front() { return *Begin(); } NODISCARD FORCEINLINE constexpr const ElementType& Front() const { return *Begin(); } NODISCARD FORCEINLINE constexpr ElementType& Back() { return *(End() - 1); } NODISCARD FORCEINLINE constexpr const ElementType& Back() const { return *(End() - 1); } /** Overloads the GetTypeHash algorithm for TStaticArray. */ NODISCARD friend FORCEINLINE constexpr size_t GetTypeHash(const TStaticArray& A) requires (CHashable) { size_t Result = 0; for (ConstIterator Iter = A.Begin(); Iter != A.End(); ++Iter) { Result = HashCombine(Result, GetTypeHash(*Iter)); } return Result; } /** Overloads the Swap algorithm for TStaticArray. */ friend FORCEINLINE constexpr void Swap(TStaticArray& A, TStaticArray& B) requires (CSwappable) { Swap(A._, B._); } ENABLE_RANGE_BASED_FOR_LOOP_SUPPORT T _[N]; }; template requires (true && ... && CSameAs) TStaticArray(T, U...) -> TStaticArray; /** Creates a TStaticArray object from a built-in array. */ template constexpr TStaticArray, N> ToArray(T(& Array)[N]) { return [&Array](TIndexSequence) -> TStaticArray, N> { return { Array[Indices]... }; } (TMakeIndexSequence()); } /** Creates a TStaticArray object from a built-in array. */ template constexpr TStaticArray, N> ToArray(T(&& Array)[N]) { return [&Array](TIndexSequence) -> TStaticArray, N> { return { MoveTemp(Array[Indices])... }; } (TMakeIndexSequence()); } NAMESPACE_MODULE_END(Utility) NAMESPACE_MODULE_END(Redcraft) NAMESPACE_REDCRAFT_END NAMESPACE_STD_BEGIN // Support structure binding, should not be directly used. template struct tuple_size> : integral_constant { }; template struct tuple_element> { using type = T; }; NAMESPACE_STD_END NAMESPACE_REDCRAFT_BEGIN NAMESPACE_MODULE_BEGIN(Redcraft) NAMESPACE_MODULE_BEGIN(Utility) // Support structure binding, should not be directly used. template FORCEINLINE constexpr decltype(auto) get( TStaticArray& InValue) { return static_cast< TStaticArray& >(InValue)[Index]; } template FORCEINLINE constexpr decltype(auto) get(const TStaticArray& InValue) { return static_cast& >(InValue)[Index]; } template FORCEINLINE constexpr decltype(auto) get( TStaticArray&& InValue) { return static_cast< TStaticArray&&>(InValue)[Index]; } template FORCEINLINE constexpr decltype(auto) get(const TStaticArray&& InValue) { return static_cast&&>(InValue)[Index]; } NAMESPACE_MODULE_END(Utility) NAMESPACE_MODULE_END(Redcraft) NAMESPACE_REDCRAFT_END