WCONCAT2

Die Funktion verkettet zwei beliebig lange Zeichenfolgen vom Datentyp WSTRING und prüft, ob die resultierende Zeichenfolge länger als eine vorgegebene Ausgabe-Zeichenfolge ist. In diesem Fall wird die Zeichenfolge abgeschnitten.

Die Funktion liefert

TRUE, wenn die Verkettung erfolgreich war.
FALSE, wenn die resultierende Zeichenfolge länger ist als die Ausgabe-Zeichenfolge und nicht in den gegebenen Ausgangspuffer passt. Der Speicherbedarf der resultierenden Zeichenfolge ist größer als der der Ausgabe-Zeichenfolge. Die Zeichenfolge wird dann abgeschnitten.

Die Funktion stoppt die Überprüfung der Eingangslängen nach Parameterlist.cMaxCharacters Zeichen, um eine Endlosschleife zu vermeiden

FUNCTION WCONCAT2 : BOOL

VAR_INPUT

VAR_INPUT
    pSrcWString1 : POINTER TO WSTRING;
    pSrcWString2 : POINTER TO WSTRING;
    pDstWString  : POINTER TO WSTRING;
    nDstSize     : UDINT;
END_VAR

pSrcWString1: Zeiger auf die erste der zu verkettenden WSTRING-Variable (Eingabe-Zeichenfolge)

pSrcWString2: Zeiger auf die zweite der zu verkettenden WSTRING-Variable (Eingabe-Zeichenfolge)

pDstWString: Zeiger auf die resultierende WSTRING-Variable nach der Verkettung (Ausgabe-Zeichenfolge)

nDstSize: Größe der resultierenden WSTRING-Variablen (Ausgabe-Zeichenfolge) in Bytes. Bei der Zuweisung kann der Operator SIZEOF() verwendet werden.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.4022	PC oder CX (x86, x64, ARM)	Tc2_Utilities (System) >= 3.3.21.0