150 lines
4.2 KiB
C++
150 lines
4.2 KiB
C++
#pragma once
|
|
|
|
#include "CoreTypes.h"
|
|
#include "TypeTraits/Miscellaneous.h"
|
|
#include "TypeTraits/SupportedOperations.h"
|
|
|
|
NAMESPACE_REDCRAFT_BEGIN
|
|
NAMESPACE_MODULE_BEGIN(Redcraft)
|
|
NAMESPACE_MODULE_BEGIN(Utility)
|
|
|
|
/** Forms lvalue reference to const type of 'Ref'. */
|
|
template <typename T>
|
|
FORCEINLINE constexpr const T& AsConst(T& Ref)
|
|
{
|
|
return Ref;
|
|
}
|
|
|
|
/** The const rvalue reference overload is deleted to disallow rvalue arguments. */
|
|
template <typename T>
|
|
void AsConst(const T&& Ref) = delete;
|
|
|
|
/** MoveTemp will cast a reference to an rvalue reference. */
|
|
template <typename T>
|
|
FORCEINLINE constexpr TRemoveReference<T>&& MoveTemp(T&& Obj)
|
|
{
|
|
using FCastType = TRemoveReference<T>;
|
|
return static_cast<FCastType&&>(Obj);
|
|
}
|
|
|
|
/** CopyTemp will enforce the creation of an rvalue which can bind to rvalue reference parameters. */
|
|
template <typename T>
|
|
FORCEINLINE constexpr T CopyTemp(T& Obj)
|
|
{
|
|
return const_cast<const T&>(Obj);
|
|
}
|
|
|
|
/** CopyTemp will enforce the creation of an rvalue which can bind to rvalue reference parameters. */
|
|
template <typename T>
|
|
FORCEINLINE constexpr T CopyTemp(const T& Obj)
|
|
{
|
|
return Obj;
|
|
}
|
|
|
|
/** CopyTemp will enforce the creation of an rvalue which can bind to rvalue reference parameters. */
|
|
template <typename T>
|
|
FORCEINLINE constexpr T&& CopyTemp(T&& Obj)
|
|
{
|
|
// If we already have an rvalue, just return it unchanged, rather than needlessly creating yet another rvalue from it.
|
|
return MoveTemp(Obj);
|
|
}
|
|
|
|
/** Forwards lvalues as either lvalues or as rvalues, depending on T. */
|
|
template <typename T>
|
|
FORCEINLINE constexpr T&& Forward(TRemoveReference<T>& Obj)
|
|
{
|
|
return static_cast<T&&>(Obj);
|
|
}
|
|
|
|
/** Forwards lvalues as either lvalues or as rvalues, depending on T. */
|
|
template <typename T>
|
|
FORCEINLINE constexpr T&& Forward(TRemoveReference<T>&& Obj)
|
|
{
|
|
return static_cast<T&&>(Obj);
|
|
}
|
|
|
|
/** Exchanges the given values. */
|
|
template <typename T> requires (CMoveConstructible<T> && CMoveAssignable<T>)
|
|
FORCEINLINE constexpr void Swap(T& A, T& B)
|
|
{
|
|
T Temp = MoveTemp(A);
|
|
A = MoveTemp(B);
|
|
B = MoveTemp(Temp);
|
|
}
|
|
|
|
/** Overloads the Swap algorithm for arrays. */
|
|
template <typename T, size_t N> requires (requires(T& A, T& B) { Swap(A, B); })
|
|
FORCEINLINE constexpr void Swap(T(&A)[N], T(&B)[N])
|
|
{
|
|
for (size_t Index = 0; Index != N; ++Index)
|
|
{
|
|
Swap(A[Index], B[Index]);
|
|
}
|
|
}
|
|
|
|
/** Replaces the value of 'A' with 'B' and returns the old value of 'A'. */
|
|
template <typename T, typename U = T> requires (CMoveConstructible<T> && CAssignableFrom<T&, U>)
|
|
FORCEINLINE constexpr T Exchange(T& A, U&& B)
|
|
{
|
|
T Temp = MoveTemp(A);
|
|
A = Forward<U>(B);
|
|
return Temp;
|
|
}
|
|
|
|
/**
|
|
* Converts any type T to a reference type, making it possible to use member functions
|
|
* in decltype expressions without the need to go through constructors.
|
|
*/
|
|
template <typename T>
|
|
TAddRValueReference<T> DeclVal();
|
|
|
|
struct FIgnore final
|
|
{
|
|
template <typename T>
|
|
FORCEINLINE constexpr void operator=(T&&) const { }
|
|
};
|
|
|
|
/**
|
|
* An object of unspecified type such that any value can be assigned to it with no effect.
|
|
* Intended for use with Tie when unpacking a TTuple, as placeholders for unused arguments
|
|
* or using Ignore to avoid warnings about unused return values from NODISCARD functions.
|
|
*/
|
|
inline constexpr FIgnore Ignore;
|
|
|
|
// This macro is used in place of using type aliases, see Atomic.h, etc
|
|
#define STRONG_INHERIT(...) /* BaseClass */ \
|
|
/* struct DerivedClass : */ public __VA_ARGS__ \
|
|
{ \
|
|
private: \
|
|
\
|
|
using BaseClassTypedef = __VA_ARGS__; \
|
|
\
|
|
public: \
|
|
\
|
|
using BaseClassTypedef::BaseClassTypedef; \
|
|
using BaseClassTypedef::operator=; \
|
|
\
|
|
}
|
|
|
|
/**
|
|
* This class is used to create a set of overloaded functions.
|
|
*
|
|
* Visit(TOverloaded {
|
|
* [](auto A) { ... },
|
|
* [](double A) { ... },
|
|
* [](const FString& A) { ... },
|
|
* }, Target);
|
|
*/
|
|
template <typename... Ts>
|
|
struct TOverloaded final : Ts...
|
|
{
|
|
using Ts::operator()...;
|
|
};
|
|
|
|
template <typename... Ts>
|
|
TOverloaded(Ts...) -> TOverloaded<Ts...>;
|
|
|
|
NAMESPACE_MODULE_END(Utility)
|
|
NAMESPACE_MODULE_END(Redcraft)
|
|
NAMESPACE_REDCRAFT_END
|