TStringView

Navigation

API > API/Runtime > API/Runtime/Core > API/Runtime/Core/Containers

References

Syntax

template<typename CharType>  
class TStringView  
Copy full snippet

template<typename CharType> class TStringView

Remarks

A string view is a non-owning view of a range of characters.

Ensure that the underlying string is valid for the lifetime of the string view.

Be careful when constructing a string view from a temporary. Make a local copy if necessary.

FStringView View = Object->GetPathName(); // Invalid

FString PathName = Object->GetPathName(); // Valid FStringView View = PathName;

void ProcessPath(FStringView Path); // Valid ProcessPath(Object->GetPathName());

A string view is implicitly constructible from null-terminated strings, from contiguous ranges of characters such as FString and TStringBuilder, and from literals such as TEXTVIEW("...").

A string view is cheap to copy and is meant to be passed by value. Avoid passing by reference.

A string view is not guaranteed to represent a null-terminated string.

Log or format a string view using UE_LOG(TEXT("%.*s"), View.Len(), View.GetData());

A string view is a good fit for function parameters where the function has no requirements for how the string is stored. A caller may use FString, FStringView, TStringBuilder, a char array, a null-terminated string, or any other type which can convert to a string view.

The UE::String namespace contains many functions that can operate on string views. Most of these functions can be found in String/___.h in Core.

voidUseString(FStringViewInString);FStringString(TEXT("ABC"));constTCHAR*CString=*String;TStringBuilder<16>StringBuilder;StringBuilder.Append(TEXT("ABC"));UseString(String);UseString(CString);UseString(StringBuilder);UseString(TEXT("ABC"));UseString(TEXTVIEW("ABC"));

Variables

Constructors

Functions

Operators

Typedefs