#pragma once #include "CoreTypes.h" #include "Templates/Utility.h" #include "Templates/TypeHash.h" #include "TypeTraits/TypeTraits.h" #include "Miscellaneous/Compare.h" #include "Miscellaneous/AssertionMacros.h" NAMESPACE_REDCRAFT_BEGIN NAMESPACE_MODULE_BEGIN(Redcraft) NAMESPACE_MODULE_BEGIN(Utility) template <typename OptionalType> requires (CDestructible<OptionalType>) class TOptional; NAMESPACE_PRIVATE_BEGIN template <typename T> struct TIsTOptional : FFalse { }; template <typename T> struct TIsTOptional<TOptional<T>> : FTrue { }; template <typename T, typename U> concept CTOptionalAllowUnwrappable = !(CConstructibleFrom<U, TOptional<T>& > || CConstructibleFrom<U, const TOptional<T>& > || CConstructibleFrom<U, TOptional<T>&&> || CConstructibleFrom<U, const TOptional<T>&&> || CConvertibleTo< TOptional<T>&, U> || CConvertibleTo<const TOptional<T>&, U> || CConvertibleTo< TOptional<T>&&, U> || CConvertibleTo<const TOptional<T>&&, U> || CAssignableFrom<U&, TOptional<T>& > || CAssignableFrom<U&, const TOptional<T>& > || CAssignableFrom<U&, TOptional<T>&&> || CAssignableFrom<U&, const TOptional<T>&&>); NAMESPACE_PRIVATE_END template <typename T> concept CTOptional = NAMESPACE_PRIVATE::TIsTOptional<TRemoveCV<T>>::Value; /** The class template manages an optional contained value, i.e. a value that may or may not be present. */ template <typename OptionalType> requires (CDestructible<OptionalType>) class TOptional final { public: using ValueType = OptionalType; /** Constructs an object that does not contain a value. */ FORCEINLINE constexpr TOptional() : bIsValid(false) { } /** Constructs an object that does not contain a value. */ FORCEINLINE constexpr TOptional(FInvalid) : TOptional() { } /** Constructs an object with initial content an object, direct-initialized from Forward<T>(InValue). */ template <typename T = OptionalType> requires (CConstructibleFrom<OptionalType, T&&>) && (!CSameAs<TRemoveCVRef<T>, FInPlace>) && (!CSameAs<TOptional, TRemoveCVRef<T>>) FORCEINLINE constexpr explicit (!CConvertibleTo<T&&, OptionalType>) TOptional(T&& InValue) : TOptional(InPlace, Forward<T>(InValue)) { } /** Constructs an object with initial content an object, direct-non-list-initialized from Forward<Ts>(Args).... */ template <typename... Ts> requires (CConstructibleFrom<OptionalType, Ts...>) FORCEINLINE constexpr explicit TOptional(FInPlace, Ts&&... Args) : bIsValid(true) { new (&Value) OptionalType(Forward<Ts>(Args)...); } /** Constructs an object with initial content an object, direct-non-list-initialized from IL, Forward<Ts>(Args).... */ template <typename U, typename... Ts> requires (CConstructibleFrom<OptionalType, initializer_list<U>, Ts...>) FORCEINLINE constexpr explicit TOptional(FInPlace, initializer_list<U> IL, Ts&&... Args) : bIsValid(true) { new (&Value) OptionalType(IL, Forward<Ts>(Args)...); } /** Copies content of other into a new instance. */ FORCEINLINE constexpr TOptional(const TOptional& InValue) requires (CTriviallyCopyConstructible<OptionalType>) = default; /** Copies content of other into a new instance. */ FORCEINLINE constexpr TOptional(const TOptional& InValue) requires (CCopyConstructible<OptionalType> && !CTriviallyCopyConstructible<OptionalType>) : bIsValid(InValue.IsValid()) { if (InValue.IsValid()) new (&Value) OptionalType(InValue.GetValue()); } /** Moves content of other into a new instance. */ FORCEINLINE constexpr TOptional(TOptional&& InValue) requires (CTriviallyMoveConstructible<OptionalType>) = default; /** Moves content of other into a new instance. */ FORCEINLINE constexpr TOptional(TOptional&& InValue) requires (CMoveConstructible<OptionalType> && !CTriviallyMoveConstructible<OptionalType>) : bIsValid(InValue.IsValid()) { if (InValue.IsValid()) new (&Value) OptionalType(MoveTemp(InValue.GetValue())); } /** Converting copy constructor. */ template <typename T = OptionalType> requires (CConstructibleFrom<OptionalType, const T&> && NAMESPACE_PRIVATE::CTOptionalAllowUnwrappable<T, OptionalType>) FORCEINLINE constexpr explicit (!CConvertibleTo<const T&, OptionalType>) TOptional(const TOptional<T>& InValue) : bIsValid(InValue.IsValid()) { if (InValue.IsValid()) new (&Value) OptionalType(InValue.GetValue()); } /** Converting move constructor. */ template <typename T = OptionalType> requires (CConstructibleFrom<OptionalType, T&&> && NAMESPACE_PRIVATE::CTOptionalAllowUnwrappable<T, OptionalType>) FORCEINLINE constexpr explicit (!CConvertibleTo<T&&, OptionalType>) TOptional(TOptional<T>&& InValue) : bIsValid(InValue.IsValid()) { if (InValue.IsValid()) new (&Value) OptionalType(MoveTemp(InValue.GetValue())); } /** Destroys the contained object, if any, as if by a call to Reset(). */ FORCEINLINE constexpr ~TOptional() requires (CTriviallyDestructible<OptionalType>) = default; /** Destroys the contained object, if any, as if by a call to Reset(). */ FORCEINLINE constexpr ~TOptional() requires (!CTriviallyDestructible<OptionalType>) { Reset(); } /** Assigns by copying the state of 'InValue'. */ FORCEINLINE constexpr TOptional& operator=(const TOptional& InValue) requires (CTriviallyCopyConstructible<OptionalType> && CTriviallyCopyAssignable<OptionalType>) = default; /** Assigns by copying the state of 'InValue'. */ constexpr TOptional& operator=(const TOptional& InValue) requires (CCopyConstructible<OptionalType> && CCopyAssignable<OptionalType> && !CTriviallyCopyConstructible<OptionalType> && !CTriviallyCopyAssignable<OptionalType>) { if (&InValue == this) return *this; if (!InValue.IsValid()) { Reset(); return *this; } if (IsValid()) GetValue() = InValue.GetValue(); else { new (&Value) OptionalType(InValue.GetValue()); bIsValid = true; } return *this; } /** Assigns by moving the state of 'InValue'. */ FORCEINLINE constexpr TOptional& operator=(TOptional&& InValue) requires (CTriviallyMoveConstructible<OptionalType> && CTriviallyMoveAssignable<OptionalType>) = default; /** Assigns by moving the state of 'InValue'. */ constexpr TOptional& operator=(TOptional&& InValue) requires (CMoveConstructible<OptionalType> && CMoveAssignable<OptionalType> && !CTriviallyMoveConstructible<OptionalType> && !CTriviallyMoveAssignable<OptionalType>) { if (&InValue == this) return *this; if (!InValue.IsValid()) { Reset(); return *this; } if (IsValid()) GetValue() = MoveTemp(InValue.GetValue()); else { new (&Value) OptionalType(MoveTemp(InValue.GetValue())); bIsValid = true; } return *this; } /** Assigns by copying the state of 'InValue'. */ template <typename T = OptionalType> requires (CConstructibleFrom<OptionalType, const T&> && CAssignableFrom<OptionalType&, const T&> && NAMESPACE_PRIVATE::CTOptionalAllowUnwrappable<T, OptionalType>) constexpr TOptional& operator=(const TOptional<T>& InValue) { if (!InValue.IsValid()) { Reset(); return *this; } if (IsValid()) GetValue() = InValue.GetValue(); else { new (&Value) OptionalType(InValue.GetValue()); bIsValid = true; } return *this; } /** Assigns by moving the state of 'InValue'. */ template <typename T = OptionalType> requires (CConstructibleFrom<OptionalType, T&&> && CAssignableFrom<OptionalType&, T&&> && NAMESPACE_PRIVATE::CTOptionalAllowUnwrappable<T, OptionalType>) constexpr TOptional& operator=(TOptional<T>&& InValue) { if (!InValue.IsValid()) { Reset(); return *this; } if (IsValid()) GetValue() = MoveTemp(InValue.GetValue()); else { new (&Value) OptionalType(MoveTemp(InValue.GetValue())); bIsValid = true; } return *this; } /** Assigns the value of 'InValue'. */ template <typename T = OptionalType> requires (CConstructibleFrom<OptionalType, T&&> && CAssignableFrom<OptionalType&, T&&>) FORCEINLINE constexpr TOptional& operator=(T&& InValue) { if (IsValid()) GetValue() = Forward<T>(InValue); else { new (&Value) OptionalType(Forward<T>(InValue)); bIsValid = true; } return *this; } /** Check if the two optional are equivalent. */ template <typename T = OptionalType> requires (CWeaklyEqualityComparable<OptionalType, T>) NODISCARD friend FORCEINLINE constexpr bool operator==(const TOptional& LHS, const TOptional<T>& RHS) { if (LHS.IsValid() != RHS.IsValid()) return false; if (LHS.IsValid() == false) return true; return *LHS == *RHS; } /** Check the order relationship between two optional. */ template <typename T = OptionalType> requires (CSynthThreeWayComparable<OptionalType, T>) NODISCARD friend FORCEINLINE constexpr partial_ordering operator<=>(const TOptional& LHS, const TOptional<T>& RHS) { if (LHS.IsValid() != RHS.IsValid()) return partial_ordering::unordered; if (LHS.IsValid() == false) return partial_ordering::equivalent; return SynthThreeWayCompare(*LHS, *RHS); } /** Check if the optional value is equivalent to 'InValue'. */ template <typename T = OptionalType> requires (!CTOptional<T> && CWeaklyEqualityComparable<OptionalType, T>) NODISCARD FORCEINLINE constexpr bool operator==(const T& InValue) const& { return IsValid() ? GetValue() == InValue : false; } /** Check that the optional value is in ordered relationship with 'InValue'. */ template <typename T = OptionalType> requires (!CTOptional<T> && CSynthThreeWayComparable<OptionalType, T>) NODISCARD FORCEINLINE constexpr partial_ordering operator<=>(const T& InValue) const& { return IsValid() ? SynthThreeWayCompare(GetValue(), InValue) : partial_ordering::unordered; } /** @return true if instance does not contain a value, otherwise false. */ NODISCARD FORCEINLINE constexpr bool operator==(FInvalid) const& { return !IsValid(); } /** * Changes the contained object to one constructed from the arguments. * First destroys the current contained object (if any) by Reset(), * then constructs an object, direct-non-list-initialized from Forward<Ts>(Args)..., as the contained object. * * @param Args - The arguments to be passed to the constructor of the object. * * @return A reference to the new object. */ template <typename... Ts> requires (CConstructibleFrom<OptionalType, Ts...>) FORCEINLINE constexpr OptionalType& Emplace(Ts&&... Args) { Reset(); OptionalType* Result = new (&Value) OptionalType(Forward<Ts>(Args)...); bIsValid = true; return *Result; } /** * Changes the contained object to one constructed from the arguments. * First destroys the current contained object (if any) by Reset(), * then constructs an object, direct-non-list-initialized from IL, Forward<Ts>(Args)..., as the contained object. * * @param IL, Args - The arguments to be passed to the constructor of the object. * * @return A reference to the new object. */ template <typename U, typename... Ts> requires (CConstructibleFrom<OptionalType, initializer_list<U>, Ts...>) FORCEINLINE constexpr OptionalType& Emplace(initializer_list<U> IL, Ts&&... Args) { Reset(); OptionalType* Result = new (&Value) OptionalType(IL, Forward<Ts>(Args)...); bIsValid = true; return *Result; } /** @return true if instance contains a value, otherwise false. */ NODISCARD FORCEINLINE constexpr bool IsValid() const { return bIsValid; } NODISCARD FORCEINLINE constexpr explicit operator bool() const { return bIsValid; } /** @return The contained object. */ NODISCARD FORCEINLINE constexpr OptionalType& GetValue() & { checkf(IsValid(), TEXT("It is an error to call GetValue() on an unset TOptional. Please either check IsValid() or use Get(DefaultValue) instead.")); return *reinterpret_cast< OptionalType*>(&Value); } NODISCARD FORCEINLINE constexpr OptionalType&& GetValue() && { checkf(IsValid(), TEXT("It is an error to call GetValue() on an unset TOptional. Please either check IsValid() or use Get(DefaultValue) instead.")); return MoveTemp(*reinterpret_cast< OptionalType*>(&Value)); } NODISCARD FORCEINLINE constexpr const OptionalType& GetValue() const& { checkf(IsValid(), TEXT("It is an error to call GetValue() on an unset TOptional. Please either check IsValid() or use Get(DefaultValue) instead.")); return *reinterpret_cast<const OptionalType*>(&Value); } NODISCARD FORCEINLINE constexpr const OptionalType&& GetValue() const&& { checkf(IsValid(), TEXT("It is an error to call GetValue() on an unset TOptional. Please either check IsValid() or use Get(DefaultValue) instead.")); return MoveTemp(*reinterpret_cast<const OptionalType*>(&Value)); } /** @return The pointer to the contained object. */ NODISCARD FORCEINLINE constexpr const OptionalType* operator->() const { return &GetValue(); } NODISCARD FORCEINLINE constexpr OptionalType* operator->() { return &GetValue(); } /** @return The contained object. */ NODISCARD FORCEINLINE constexpr OptionalType& operator*() & { return GetValue(); } NODISCARD FORCEINLINE constexpr OptionalType&& operator*() && { return GetValue(); } NODISCARD FORCEINLINE constexpr const OptionalType& operator*() const& { return GetValue(); } NODISCARD FORCEINLINE constexpr const OptionalType&& operator*() const&& { return GetValue(); } /** @return The contained object when IsValid() returns true, 'DefaultValue' otherwise. */ NODISCARD FORCEINLINE constexpr OptionalType& Get( OptionalType& DefaultValue) & { return IsValid() ? GetValue() : DefaultValue; } NODISCARD FORCEINLINE constexpr const OptionalType& Get(const OptionalType& DefaultValue) const& { return IsValid() ? GetValue() : DefaultValue; } /** If not empty, destroys the contained object. */ FORCEINLINE constexpr void Reset() { if (bIsValid) { bIsValid = false; typedef OptionalType DestructOptionalType; ((OptionalType*)&Value)->DestructOptionalType::~DestructOptionalType(); } } /** Overloads the GetTypeHash algorithm for TOptional. */ NODISCARD friend FORCEINLINE constexpr size_t GetTypeHash(const TOptional& A) requires (CHashable<OptionalType>) { if (!A.IsValid()) return 2824517378; return GetTypeHash(A.GetValue()); } /** Overloads the Swap algorithm for TOptional. */ friend constexpr void Swap(TOptional& A, TOptional& B) requires (CMoveConstructible<OptionalType> && CSwappable<OptionalType>) { if (!A.IsValid() && !B.IsValid()) return; if (A.IsValid() && !B.IsValid()) { B = MoveTemp(A); A.Reset(); } else if (!A.IsValid() && B.IsValid()) { A = MoveTemp(B); B.Reset(); } else { Swap(A.GetValue(), B.GetValue()); } } private: TAlignedStorage<sizeof(OptionalType), alignof(OptionalType)> Value; bool bIsValid; }; template <typename T> TOptional(T) -> TOptional<T>; /** Creates an optional object that does not contain a value. */ template <typename T> requires (CDestructible<T>) NODISCARD FORCEINLINE constexpr TOptional<T> MakeOptional(FInvalid) { return TOptional<T>(Invalid); } /** Creates an optional object from value. */ template <typename T> requires (CDestructible<TDecay<T>> && CConstructibleFrom<TDecay<T>, T>) NODISCARD FORCEINLINE constexpr TOptional<TDecay<T>> MakeOptional(T&& InValue) { return TOptional<TDecay<T>>(Forward<T>(InValue)); } /** Creates an optional object constructed in-place from Args.... */ template <typename T, typename... Ts> requires (CDestructible<T> && CConstructibleFrom<T, Ts...>) NODISCARD FORCEINLINE constexpr TOptional<T> MakeOptional(Ts&&... Args) { return TOptional<T>(InPlace, Forward<T>(Args)...); } /** Creates an optional object constructed in-place from IL, Args.... */ template <typename T, typename U, typename... Ts> requires (CDestructible<T> && CConstructibleFrom<T, initializer_list<U>, Ts...>) NODISCARD FORCEINLINE constexpr TOptional<T> MakeOptional(initializer_list<U> IL, Ts&&... Args) { return TOptional<T>(InPlace, IL, Forward<T>(Args)...); } NAMESPACE_MODULE_END(Utility) NAMESPACE_MODULE_END(Redcraft) NAMESPACE_REDCRAFT_END