ConvertUTF8toUTF16 (FUN) ¶ FUNCTION ConvertUTF8toUTF16 : UDINT This function converts an UTF-8 encoded string to an UTF-16 encoded string (may be wrong for 3 or 4 character encoded UTF16 characters). InOut: Scope Name Type Comment Return ConvertUTF8toUTF16 UDINT Input sourceStart POINTER TO BYTE Pointer to the UTF-8 string to convert targetStart POINTER TO WORD Pointer to the WSTRING the result shall be stored in dwTargetBufferSize DWORD The size (in bytes) of the buffer (targetStart) the result shall be stored in bStrictConversion BOOL Do not continue on illegal characters

GVL_UTF8 (GVL) ¶ Attributes: qualified_only InOut: Scope Name Type Initial Comment Constant trailingBytesForUTF8 ARRAY [0..255] OF BYTE [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, 3, 3, 3, 3, 3, 4, 4, 4, 4, 5, 5, 5, 5] firstByteMark ARRAY [0..6] OF BYTE [16#0, 16#0, 16#C0, 16#E0, 16#F0, 16#F8, 16#FC] offsetsFromUTF8 ARRAY [0..5] OF DWORD [16#0, 16#3080, 16#E2080, 16#3C82080, 16#FA082080, 16#82082080] halfShift INT 10 used FOR shifting BY 10 bits halfBase DWORD 16#10000 halfMask DWORD 16#3FF UNI_REPLACEMENT_CHAR DWORD 16#FFFD UNI_MAX_BMP DWORD 16#FFFF UNI_MAX_UTF16 DWORD 16#10FFFF UNI_MAX_UTF32 DWORD 16#7FFFFFFF UNI_MAX_LEGAL_UTF32 DWORD 16#10FFFF byteMask DWORD 16#BF byteMark DWORD 16#80 UNI_SUR_HIGH_START DWORD 16#D800 UNI_SUR_HIGH_END DWORD 16#DBFF UNI_SUR_LOW_START DWORD 16#DC00 UNI_SUR_LOW_END DWORD 16#DFFF ERR_SOURCE_EXHAUSTED UDINT 16#40A0 ERR_TARGET_EXHAUSTED UDINT 16#40A1 ERR_SOURCE_ILLEGAL UDINT 16#40A2

IsLegalUTF8 (FUN) ¶ FUNCTION IsLegalUTF8 : BOOL This method checks if a given string contains of valid UTF-8 characters. InOut: Scope Name Type Comment Return IsLegalUTF8 BOOL Input source POINTER TO BYTE Pointer to the string to check length INT Length of the string to check

IsSpaceCharacter (FUN) ¶ FUNCTION IsSpaceCharacter : BOOL see https://docs.microsoft.com/de-de/dotnet/api/system.char.iswhitespace?view=net-6.0#system-char-iswhitespace(system-char ) InOut: Scope Name Type Return IsSpaceCharacter BOOL Input wCharacter WORD

Unicode ¶ StrCaseCmpW (Function) StrCaseFindW (Function) StrCmpW (Function) StrConcatW (Function) StrCpyW (Function) StrDeleteW (Function) StrFindW (Function) StrIsNullOrEmptyW (Function) StrLenW (Function) StrMidW (Function) StrPadLeftW (Function) StrPadRightW (Function) StrReplaceW (Function) StrTrimEndW (Function) StrTrimStartW (Function) StrTrimW (Function) WCharToUpper (Function)

StrCaseCmpW (FUN) ¶ FUNCTION StrCaseCmpW : INT Does a case insensitive comparison of two wstrings. Case insensitive is intended only for the comparison between two ASCII characters within the strings Return values: 0 -> the strings are equal -1 -> pwd1 is less than pwd2 1 -> pwd1 is larger than pwd2 InOut: Scope Name Type Return StrCaseCmpW INT Input pwd1 POINTER TO WORD pwd2 POINTER TO WORD

StrCaseFindW (FUN) ¶ FUNCTION StrCaseFindW : INT Same semantics as Find from the standard.library. A null pointer will lead to a return of -1 InOut: Scope Name Type Comment Return StrCaseFindW INT Input pst1 POINTER TO WSTRING(255) pst2 POINTER TO WSTRING(255) uiSearchStart UINT a position relative to 1, where the search starts

StrCmpW (FUN) ¶ FUNCTION StrCmpW : INT Does a case sensitive comparison of two strings Return values: 0 -> the strings are equal -1 -> pwd1 is less than pwd2 1 -> pwd1 is larger than pwd2 InOut: Scope Name Type Return StrCmpW INT Input pwd1 POINTER TO WORD pwd2 POINTER TO WORD

StrConcatW (FUN) ¶ FUNCTION StrConcatW : BOOL This function concatenates pstFrom to pstTo if the iBufferSize from pstTo is big enough. It will return FALSE and does no concatenation if one of the strings is NULL or the buffer size is not big enough. InOut: Scope Name Type Comment Return StrConcatW BOOL Input pstFrom CharBufferPtr simply a pointer to byte pstTo CharBufferPtr simply a pointer to byte iBufferSize INT the buffer size of pstTo

StrCpyW (FUN) ¶ FUNCTION StrCpyW : DINT Does a strcpy from the source string cbsSource to cbsTarget. cbsTarget’s buffer must not be NULL! Will return the number of copied characters including the terminating ‘\0’ or “\0” InOut: Scope Name Type Comment Return StrCpyW DINT Input pBuffer CharBufferPtr iBufferSize DINT the size in bytes of the buffer pStr CharBufferPtr the source as a pointer to string