StringWriter.AppendBuffer (METH) ¶ METHOD AppendBuffer : ERROR AppendBuffer adds the passed buffer to the end of the current user data. The transfer takes place by reference and the specified free memory of this buffer is used for further use. Note Normally, buffers with a remaining length of 0 are transferred. Otherwise the original buffer might be changed with further operations! Schematic mode of operation ¶ Tip Larger constant character strings should be concatenate again and again by buffers. 1 PROGRAM PLC_PRG 2 VAR CONSTANT 3 c_wsLargeString : WSTRING ( 300 ) := 'Large information ...' ; 4 END_VAR 5 VAR 6 bfLargeString : SBM.Buffer := ( pData := ADR ( c_wsLargeString ), udiSize := 300 * 2 ); 7 StringWriter : MSU.StringWriter ; 8 9 ... 10 END_VAR 11 12 StringWriter.AppendBuffer ( itfBuffer := bfLargeString , udiFreePageSize := 0 ); 13 14 ... InOut: Scope Name Type Comment Return AppendBuffer ERROR Input itfBuffer SBM.IBuffer udiFreePageSize UDINT Buffer to append
StringWriter.AppendData (METH) ¶ METHOD PROTECTED AppendData : ERROR AppendData adds the referenced data to the end. If the free internal memory is insufficient, it is expanded and, if necessary, the data transferred is distributed among several internal administrative buffer pages. Schematic mode of operation ¶ InOut: Scope Name Type Comment Return AppendData ERROR Input pbyData POINTER TO BYTE udiSize UDINT address to raw data
StringWriter.AppendString (METH) ¶ METHOD AppendString : ERROR InOut: Scope Name Type Return AppendString ERROR Inout Const sValue STRING Input udiLength UDINT
StringWriter.AppendWString (METH) ¶ METHOD AppendWString : ERROR InOut: Scope Name Type Return AppendWString ERROR Inout Const wsValue WSTRING Input udiLength UDINT
StrLenA (FUN) ¶ FUNCTION StrLenA : UDINT This function determines the length of a string by searching for a terminating zero character. The function will do its work either with native IEC-Strings or with strings coming from external functions. It will return 0 and eError = ERROR.INVALID_PARAMETER if the given pointer to String is equal NULL InOut: Scope Name Type Comment Return StrLenA UDINT Input pstData CharBufferPtr simply a pointer to byte Output eError ERROR
StrLenW (FUN) ¶ FUNCTION StrLenW : UDINT This function determines the length of a string by searching for a terminating zero character. The function will do its work either with native IEC-WStrings or with strings coming from external functions. It will return 0 and eError = ERROR.INVALID_PARAMETER if the given pointer to String is equal NULL InOut: Scope Name Type Comment Return StrLenW UDINT Input pstData CharBufferPtr simply a pointer to byte Output eError ERROR
StrMidA (FUN) ¶ FUNCTION StrMidA : ERROR Return <iLength> characters of <pst>, beginning at the <iPosition>-th character position. <iPosition> = 1 is the first character. This function has been adapted from StrMidW InOut: Scope Name Type Comment Return StrMidA ERROR Input pst POINTER TO BYTE udiLength UDINT udiPosition UDINT pstResult POINTER TO BYTE The buffer, where the result will be returned udiResultBufferSize UDINT The size of the buffer (in bytes), where the result will be returned
StrReplaceW (FUN) ¶ FUNCTION StrReplaceW Replaces <iLengthToReplace> wcharacters of pstInput by pstReplaceWith, starting at the <iPosition>-th wcharacter position iPosition = 1 is the first character. InOut: Scope Name Type Comment Input pstInput POINTER TO WSTRING(255) udiInputBufferSize UDINT The size of the buffer, where pstInput points to pstReplaceWith POINTER TO WSTRING(255) udiLengthInput UDINT udiLengthToReplace UDINT udiLengthToReplaceWith UDINT udiPosition UDINT
StrToUpperA (FUN) ¶ FUNCTION StrToUpperA : ERROR Converts all letters to upper case. InOut: Scope Name Type Comment Return StrToUpperA ERROR Input pString CharBufferPtr Pointer to the string.
StrTrimW (FUN) ¶ FUNCTION StrTrimW Remove leading and trailing whitespaces (ASCII 9, 10, 13, 32). InOut: Scope Name Type Comment Input pString POINTER TO WORD Pointer to the string to be trimmed.