StringCast

Navigation

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

References

template<typename To, int32 DefaultConversionSize, typename From>  
auto StringCast  
(  
    const From * Str  
)  
Copy full snippet

template<typename To, int32 DefaultConversionSize, typename From> auto StringCast (     const From * Str )

Remarks

StringCast example usage:

void Func(const FString& Str, const TCHAR* MediumLong, FStringView MediumLongSV) { // Basic version auto Src = StringCast(Str); const ANSICHAR Ptr = Src.Get(); // Ptr is a pointer to an ANSICHAR representing the potentially-converted string data. // Avoid calling strlen auto NoStrlenString = StringCast(MediumLongSV.GetData(), MediumLongSV.Len()); // Specify the static allocation size when maximum length is known auto NoAllocSrc = StringCast(MediumLong); // Avoid calling strlen and also specify the allocation size auto NoAllocNoStrlenSrc = StringCast(MediumLongSV.GetData(), MediumLongSV.Len()); } Creates an object which acts as a source of a given string type. See example above.

StringCast expects correctly-typed strings. If a cast is attempted with a char* or ANSICHAR*, and the string contains characters that are non-ASCII, including UTF-8 code units outside of the 7-bit ASCII range, then those values will fail to convert and a bogus char will be written in their place.

If a conversion from UTF-8 is desired, the pointer should be cast to UTF8CHAR* before being passed to StringCast.

Similarly, doing a StringCast or StringCast on a Unicode string will only successfully convert Unicode characters which already lie in the ASCII range. For converting to UTF-8, StringCast should be used.

The source string must not be modified or destroyed until after the result of this function has been destroyed.

Parameters

Name	Description
Str	The null-terminated source string to convert.