#pragma once #include "CoreTypes.h" #include "TypeTraits/TypeTraits.h" #include "Templates/Utility.h" #include "Templates/TypeHash.h" #include "Templates/Noncopyable.h" #include "Memory/Allocators.h" #include "Memory/MemoryOperator.h" #include "Containers/ArrayView.h" #include "Iterators/Utility.h" #include "Iterators/BasicIterator.h" #include "Iterators/Sentinel.h" #include "Strings/Char.h" #include "Strings/Convert.h" #include "Miscellaneous/AssertionMacros.h" #include #include NAMESPACE_REDCRAFT_BEGIN NAMESPACE_MODULE_BEGIN(Redcraft) NAMESPACE_MODULE_BEGIN(Utility) template class TStringView; template Allocator> class TString; NAMESPACE_PRIVATE_BEGIN template struct TIsTStringView : FFalse { }; template struct TIsTStringView> : FTrue { }; template class TCStringFromTStringView final : FNoncopyable { public: FORCEINLINE TCStringFromTStringView(const T* InPtr, bool bInDelete) : Ptr(InPtr), bDelete(bInDelete) { } FORCEINLINE TCStringFromTStringView(TCStringFromTStringView&& InValue) : Ptr(InValue.Ptr), bDelete(Exchange(InValue.bDelete, false)) { } FORCEINLINE ~TCStringFromTStringView() { if (bDelete) delete[] Ptr; } FORCEINLINE TCStringFromTStringView& operator=(TCStringFromTStringView&& InValue) { if (bDelete) delete[] Ptr; Ptr = InValue.Ptr; bDelete = Exchange(InValue.bDelete, false); return *this; } NODISCARD FORCEINLINE operator const T*() const { return Ptr; } private: const T* Ptr; bool bDelete; }; NAMESPACE_PRIVATE_END template concept CTStringView = NAMESPACE_PRIVATE::TIsTStringView>::Value; /** * The class template TStringView describes an object that can refer to a constant contiguous sequence of char-like objects * with the first element of the sequence at position zero. Provides a set of convenient string processing functions. */ template class TStringView : public TArrayView { private: using FSuper = TArrayView; public: using FElementType = T; using FReference = typename FSuper::FReference; using FIterator = typename FSuper:: FIterator; using FReverseIterator = typename FSuper::FReverseIterator; static_assert(CContiguousIterator); /** Constructs an empty string view. */ FORCEINLINE constexpr TStringView() = default; /** Constructs a string view that is a view over the range ['InFirst', 'InFirst' + 'Count'). */ template requires (CConvertibleTo, T> && CSameAs>, TRemoveCVRef>) FORCEINLINE constexpr TStringView(I InFirst, size_t InCount) : FSuper(InFirst, InCount) { } /** Constructs a string view that is a view over the range ['InFirst', 'InLast'). */ template S> requires (CConvertibleTo, T> && CSameAs>, TRemoveCVRef>) FORCEINLINE constexpr TStringView(I InFirst, S InLast) : FSuper(InFirst, InLast) { } /** Constructs a string view that is a view over the string 'InString'. */ template FORCEINLINE constexpr TStringView(const TString& InString); /** Constructs a string view that is a view over the range ['InPtr', 'InPtr' + 'Count'). */ FORCEINLINE constexpr TStringView(const FElementType* InPtr, size_t Count) : FSuper(InPtr, Count) { checkf(InPtr != nullptr, TEXT("TStringView cannot be initialized by nullptr. Please check the pointer.")); } FORCEINLINE constexpr TStringView(nullptr_t, size_t) = delete; /** Constructs a string view that is a view over the range ['InPtr', '\0'). */ FORCEINLINE constexpr TStringView(const FElementType* InPtr) { checkf(InPtr != nullptr, TEXT("TStringView cannot be initialized by nullptr. Please check the pointer.")); size_t Length = 0; if constexpr (CSameAs) { Length = NAMESPACE_STD::strlen(InPtr); } else if constexpr (CSameAs) { Length = NAMESPACE_STD::wcslen(InPtr); } else { while (InPtr[Length] != LITERAL(FElementType, '\0')) ++Length; } *this = TStringView(InPtr, Length); } FORCEINLINE constexpr TStringView(nullptr_t) = delete; /** Defaulted copy constructor copies the size and data pointer. */ FORCEINLINE constexpr TStringView(const TStringView&) = default; /** Assigns other to *this. This defaulted assignment operator performs a shallow copy of the data pointer and the size. */ FORCEINLINE constexpr TStringView& operator=(const TStringView&) noexcept = default; /** Compares the contents of two string views. */ NODISCARD friend constexpr bool operator==(TStringView LHS, TStringView RHS) { return static_cast(LHS) == static_cast(RHS); } /** Compares the contents of a string view and a character. */ NODISCARD friend constexpr bool operator==(TStringView LHS, FElementType RHS) { return LHS == TStringView(&RHS, 1); } NODISCARD friend constexpr bool operator==(FElementType LHS, TStringView RHS) { return TStringView(&LHS, 1) == RHS; } /** Compares the contents of two string views. */ NODISCARD friend constexpr auto operator<=>(TStringView LHS, TStringView RHS) { return static_cast(LHS) <=> static_cast(RHS); } /** Compares the contents of a string view and a character. */ NODISCARD friend constexpr auto operator<=>(TStringView LHS, FElementType RHS) { return LHS <=> TStringView(&RHS, 1); } NODISCARD friend constexpr auto operator<=>(FElementType LHS, TStringView RHS) { return TStringView(&LHS, 1) <=> RHS; } public: /** Shrinks the view by moving its start forward. */ FORCEINLINE constexpr TStringView& RemovePrefix(size_t Count) { checkf(Count <= this->Num(), TEXT("Illegal subview range. Please check Count.")); *this = Substr(Count); return *this; } /** Shrinks the view by moving its end backward. */ FORCEINLINE constexpr TStringView& RemoveSuffix(size_t Count) { checkf(Count <= this->Num(), TEXT("Illegal subview range. Please check Count.")); *this = Substr(0, this->Num() - Count); return *this; } /** Removes whitespace characters from the start of this string. */ FORCEINLINE constexpr TStringView& TrimStart() { auto Index = Find([](FElementType Char) { return !TChar::IsSpace(Char); }); if (Index != INDEX_NONE) { RemovePrefix(Index); } else *this = TStringView(); return *this; } /** Removes whitespace characters from the end of this string. */ FORCEINLINE constexpr TStringView& TrimEnd() { auto Index = RFind([](FElementType Char) { return !TChar::IsSpace(Char); }); if (Index != INDEX_NONE) { RemoveSuffix(this->Num() - Index - 1); } else *this = TStringView(); return *this; } /** Removes whitespace characters from the start and end of this string. */ FORCEINLINE constexpr TStringView& TrimStartAndEnd() { TrimStart(); TrimEnd(); return *this; } /** Removes characters after the first null-terminator. */ FORCEINLINE constexpr TStringView& TrimToNullTerminator() { auto Index = Find(LITERAL(FElementType, '\0')); if (Index != INDEX_NONE) { *this = Substr(0, Index); } return *this; } public: /** Copies the elements of this string view to the destination buffer without null-termination. */ FORCEINLINE constexpr size_t Copy(FElementType* Dest, size_t Count = DynamicExtent, size_t Offset = 0) const { checkf(Dest != nullptr, TEXT("Illegal destination buffer. Please check the pointer.")); checkf(Offset <= this->Num() && (Count == DynamicExtent || Offset + Count <= this->Num()), TEXT("Illegal subview range. Please check Offset and Count.")); if (Count == DynamicExtent) { Count = this->Num() - Offset; } Memory::CopyAssign(Dest, this->GetData() + Offset, Count); return Count; } FORCEINLINE constexpr size_t Copy(nullptr_t, size_t Count = DynamicExtent, size_t Offset = 0) const = delete; /** Obtains an array view that is a view over the first 'Count' elements of this array view. */ NODISCARD FORCEINLINE constexpr TStringView First(size_t Count) const { checkf(Count <= this->Num(), TEXT("Illegal subview range. Please check Count.")); return Substr(0, Count); } /** Obtains an array view that is a view over the last 'Count' elements of this array view. */ NODISCARD FORCEINLINE constexpr TStringView Last(size_t Count) const { checkf(Count <= this->Num(), TEXT("Illegal subview range. Please check Count.")); return Substr(this->Num() - Count); } /** Obtains a string view that is a view over the 'Count' elements of this string view starting at 'Offset'. */ NODISCARD FORCEINLINE constexpr TStringView Substr(size_t Offset, size_t Count = DynamicExtent) const { checkf(Offset <= this->Num() && (Count == DynamicExtent || Offset + Count <= this->Num()), TEXT("Illegal subview range. Please check Offset and Count.")); FSuper Temp = this->Subview(Offset, Count); return TStringView(Temp.GetData(), Temp.Num()); } /** @return true if the string view starts with the given prefix, false otherwise. */ NODISCARD FORCEINLINE constexpr bool StartsWith(TStringView Prefix) const { return this->Num() >= Prefix.Num() && Substr(0, Prefix.Num()) == Prefix; } /** @return true if the string view starts with the given prefix, false otherwise. */ NODISCARD FORCEINLINE constexpr bool StartsWith(FElementType Prefix) const { return this->Num() >= 1 && this->Front() == Prefix; } /** @return true if the string view ends with the given suffix, false otherwise. */ NODISCARD FORCEINLINE constexpr bool EndsWith(TStringView Suffix) const { return this->Num() >= Suffix.Num() && Substr(this->Num() - Suffix.Num(), Suffix.Num()) == Suffix; } /** @return true if the string view ends with the given suffix, false otherwise. */ NODISCARD FORCEINLINE constexpr bool EndsWith(FElementType Suffix) const { return this->Num() >= 1 && this->Back() == Suffix; } /** @return true if the string view contains the given substring, false otherwise. */ NODISCARD FORCEINLINE constexpr bool Contains(TStringView View) const { return Find(View) != INDEX_NONE; } /** @return true if the string view contains the given character, false otherwise. */ NODISCARD FORCEINLINE constexpr bool Contains(FElementType Char) const { return Find(Char) != INDEX_NONE; } /** @return true if the string view contains character that satisfy the given predicate, false otherwise. */ template F> NODISCARD FORCEINLINE constexpr bool Contains(F&& InPredicate) const { return Find(Forward(InPredicate)) != INDEX_NONE; } /** @return The index of the first occurrence of the given substring, or INDEX_NONE if not found. */ NODISCARD constexpr size_t Find(TStringView View, size_t Index = 0) const { if (Index >= this->Num()) return INDEX_NONE; if (View.Num() > this->Num()) return INDEX_NONE; if (View.Num() == 0) return Index; for (; Index != this->Num() - View.Num() + 1; ++Index) { if (Substr(Index).StartsWith(View)) { return Index; } } return INDEX_NONE; } /** @return The index of the first occurrence of the given character, or INDEX_NONE if not found. */ NODISCARD constexpr size_t Find(FElementType Char, size_t Index = 0) const { if (Index >= this->Num()) return INDEX_NONE; for (; Index != this->Num(); ++Index) { if ((*this)[Index] == Char) { return Index; } } return INDEX_NONE; } /** @return The index of the first occurrence of the character that satisfy the given predicate, or INDEX_NONE if not found. */ template F> NODISCARD constexpr size_t Find(F&& InPredicate, size_t Index = 0) const { if (Index >= this->Num()) return INDEX_NONE; for (; Index != this->Num(); ++Index) { if (InvokeResult(Forward(InPredicate), (*this)[Index])) { return Index; } } return INDEX_NONE; } /** @return The index of the last occurrence of the given substring, or INDEX_NONE if not found. */ NODISCARD constexpr size_t RFind(TStringView View, size_t Index = INDEX_NONE) const { if (Index != INDEX_NONE && Index >= this->Num()) return INDEX_NONE; if (View.Num() > this->Num()) return INDEX_NONE; if (Index == INDEX_NONE) Index = this->Num(); if (View.Num() == 0) return Index; for (; Index != View.Num() - 1; --Index) { if (Substr(0, Index).EndsWith(View)) { return Index - View.Num(); } } return INDEX_NONE; } /** @return The index of the last occurrence of the given character, or INDEX_NONE if not found. */ NODISCARD constexpr size_t RFind(FElementType Char, size_t Index = INDEX_NONE) const { if (Index != INDEX_NONE && Index >= this->Num()) return INDEX_NONE; if (Index == INDEX_NONE) Index = this->Num(); for (; Index != 0; --Index) { if ((*this)[Index - 1] == Char) { return Index - 1; } } return INDEX_NONE; } /** @return The index of the last occurrence of the character that satisfy the given predicate, or INDEX_NONE if not found. */ template F> NODISCARD constexpr size_t RFind(F&& InPredicate, size_t Index = INDEX_NONE) const { if (Index != INDEX_NONE && Index >= this->Num()) return INDEX_NONE; if (Index == INDEX_NONE) Index = this->Num(); for (; Index != 0; --Index) { if (InvokeResult(Forward(InPredicate), (*this)[Index - 1])) { return Index - 1; } } return INDEX_NONE; } /** @return The index of the first occurrence of the character contained in the given view, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindFirstOf(TStringView View, size_t Index = 0) const { return Find([View](FElementType Char) { return View.Contains(Char); }, Index); } /** @return The index of the first occurrence of the given character, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindFirstOf(FElementType Char, size_t Index = 0) const { return Find(Char, Index); } /** @return The index of the last occurrence of the character contained in the given view, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindLastOf(TStringView View, size_t Index = INDEX_NONE) const { return RFind([View](FElementType Char) { return View.Contains(Char); }, Index); } /** @return The index of the last occurrence of the given character, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindLastOf(FElementType Char, size_t Index = INDEX_NONE) const { return RFind(Char, Index); } /** @return The index of the first absence of the character contained in the given view, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindFirstNotOf(TStringView View, size_t Index = 0) const { return Find([View](FElementType Char) { return !View.Contains(Char); }, Index); } /** @return The index of the first absence of the given character, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindFirstNotOf(FElementType Char, size_t Index = 0) const { return Find([Char](FElementType C) { return C != Char; }, Index); } /** @return The index of the last absence of the character contained in the given view, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindLastNotOf(TStringView View, size_t Index = INDEX_NONE) const { return RFind([View](FElementType Char) { return !View.Contains(Char); }, Index); } /** @return The index of the last absence of the given character, or INDEX_NONE if not found. */ NODISCARD FORCEINLINE constexpr size_t FindLastNotOf(FElementType Char, size_t Index = INDEX_NONE) const { return RFind([Char](FElementType C) { return C != Char; }, Index); } public: /** @return The non-modifiable standard C character string version of the string view. */ NODISCARD FORCEINLINE auto operator*() const { if (this->Back() == LITERAL(FElementType, '\0') || Contains(LITERAL(FElementType, '\0'))) { return NAMESPACE_PRIVATE::TCStringFromTStringView(this->GetData(), false); } FElementType* Buffer = new FElementType[this->Num() + 1]; Copy(Buffer); Buffer[this->Num()] = LITERAL(FElementType, '\0'); return NAMESPACE_PRIVATE::TCStringFromTStringView(Buffer, true); } public: /** @return true if the string only contains valid characters, false otherwise. */ NODISCARD constexpr bool IsValid() const { for (FElementType Char : *this) { if (!TChar::IsValid(Char)) return false; } return true; } /** @return true if the string only contains ASCII characters, false otherwise. */ NODISCARD constexpr bool IsASCII() const { for (FElementType Char : *this) { if (!TChar::IsASCII(Char)) return false; } return true; } /** @return true if the string can be converted to a boolean value, false otherwise. */ NODISCARD FORCEINLINE constexpr bool IsBoolean() const { bool Temp; return Algorithms::Parse(*this, Temp); } /** @return true if the string can be converted to an integer value, false otherwise. */ template requires (!CSameAs && CSameAs, U>) NODISCARD FORCEINLINE constexpr bool IsInteger(uint Base = 0) const { U Temp; return Algorithms::Parse(*this, Temp, Base); } /** @return true if the string can be converted to a floating-point value, false otherwise. */ template requires (!CSameAs && CSameAs, U>) NODISCARD FORCEINLINE constexpr bool IsFloatingPoint(bool bFixed = true, bool bScientific = true, bool bHex = true) const { U Temp; return Algorithms::Parse(*this, Temp, bFixed, bScientific, bHex); } /** Converts the string into a boolean value. */ NODISCARD FORCEINLINE constexpr bool ToBool() const { bool Result; verifyf(Algorithms::Parse(*this, Result), TEXT("Illegal conversion. Please check the IsBoolean().")); return Result; } /** Converts the string into an integer value. */ template requires (!CSameAs && !CConst && !CVolatile) NODISCARD FORCEINLINE constexpr U ToInt(uint Base = 0) const { U Result; verifyf(Algorithms::Parse(*this, Result, Base), TEXT("Illegal conversion. Please check the IsInteger().")); return Result; } /** Converts the string into a floating-point value. */ template requires (!CConst && !CVolatile) NODISCARD FORCEINLINE constexpr U ToFloat(bool bFixed = true, bool bScientific = true, bool bHex = true) const { U Result; verifyf(Algorithms::Parse(*this, Result, bFixed, bScientific, bHex), TEXT("Illegal conversion. Please check the IsFloatingPoint().")); return Result; } /** Parse the string into a boolean value. */ NODISCARD FORCEINLINE constexpr bool Parse(bool& Value) { return Algorithms::Parse(*this, Value); } /** Parse the string into an integer value. */ template requires (!CSameAs && !CConst && !CVolatile) NODISCARD FORCEINLINE constexpr bool Parse(U& Value, uint Base = 0) { return Algorithms::Parse(*this, Value, Base); } /** Parse the string into a floating-point value. */ template requires (!CConst && !CVolatile) NODISCARD FORCEINLINE constexpr bool Parse(U& Value, bool bFixed = true, bool bScientific = true, bool bHex = true) { return Algorithms::Parse(*this, Value, bFixed, bScientific, bHex); } public: /** Overloads the GetTypeHash algorithm for TStringView. */ NODISCARD friend FORCEINLINE constexpr size_t GetTypeHash(TStringView A) { return GetTypeHash(static_cast(A)); } }; template TStringView(I) -> TStringView>; template TStringView(I, S) -> TStringView>; template TStringView(TString) -> TStringView; using FStringView = TStringView; using FWStringView = TStringView; using FU8StringView = TStringView; using FU16StringView = TStringView; using FU32StringView = TStringView; using FUnicodeStringView = TStringView; // ReSharper disable CppInconsistentNaming #define TEXT_VIEW(X) TStringView(TEXT(X)) #define WTEXT_VIEW(X) TStringView(WTEXT(X)) #define U8TEXT_VIEW(X) TStringView(U8TEXT(X)) #define U16TEXT_VIEW(X) TStringView(U16TEXT(X)) #define U32TEXT_VIEW(X) TStringView(U32TEXT(X)) #define UNICODETEXT_VIEW(X) TStringView(UNICODETEXT(X)) #define LITERAL_VIEW(T, X) TStringView(LITERAL(T, X)) // ReSharper restore CppInconsistentNaming NAMESPACE_MODULE_END(Utility) NAMESPACE_MODULE_END(Redcraft) NAMESPACE_REDCRAFT_END