StrCmpEndA (FUN) ¶ FUNCTION StrCmpEndA : INT Does a case sensitive comparison of the end of the string and the suffix Return values: 0 -> end of the string and suffix are equal -1 -> end of the string and suffix are NOT equal -2 -> Error: An invalid string (ie. Null-Pointer is given) InOut: Scope Name Type Comment Return StrCmpEndA INT Input pString CharBufferPtr Pointer to the string to check. pSuffix CharBufferPtr Pointer to the suffix to find.

StrCmpStartA (FUN) ¶ FUNCTION StrCmpStartA : INT Does a case sensitive comparison of the start of the string and the prefix Return values: 0 -> start of the string and prefix are equal -1 -> start of the string and prefix are NOT equal -2 -> Error: An invalid string (ie. Null-Pointer is given) InOut: Scope Name Type Comment Return StrCmpStartA INT Input pString CharBufferPtr Pointer to the string to check. pPrefix CharBufferPtr Pointer to the prefix to find.

StrConcatA (FUN) ¶ FUNCTION StrConcatA : BOOL This function concatenates pstFrom to pstTo if the iBufferSize from pstTo is big enough. The function will do its work either with native IEC-Strings or with strings coming from external functions. 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 StrConcatA BOOL Input pstFrom CharBufferPtr simply a pointer to byte pstTo CharBufferPtr simply a pointer to byte iBufferSize INT the buffer size of pstTo

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

StrDeleteA (FUN) ¶ FUNCTION StrDeleteA Deletes <iLength> characters of <pwst>, beginning at the <iPosition>-th character position. <iPosition> = 1 is the first character. This function has been adapted from StrDeleteW InOut: Scope Name Type Input pby POINTER TO BYTE iLength INT iPosition INT

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)