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

Rückgabewert

Name	Typ	Beschreibung
WCONCAT2	BOOL	Verkettet zwei beliebig lange Zeichenfolgen vom Datentyp WSTRING und prüft, ob die resultierende Zeichenfolge länger als eine vorgegebene Ausgabe-Zeichenfolge ist.

Eingänge

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

Name	Typ	Beschreibung
pSrcWString1	POINTER TO WSTRING	Zeiger auf die erste der zu verkettenden WSTRING-Variable (Eingabe-Zeichenfolge)
pSrcWString2	POINTER TO WSTRING	Zeiger auf die zweite der zu verkettenden WSTRING-Variable (Eingabe-Zeichenfolge)
pDstWString	POINTER TO WSTRING	Zeiger auf die resultierende WSTRING-Variable nach der Verkettung (Ausgabe-Zeichenfolge)
nDstSize	UDINT	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