CONCAT2

Die Funktion verkettet zwei beliebig lange Zeichenfolgen vom Datentyp STRING 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 dann 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 CONCAT2 : BOOL

Eingänge

VAR_INPUT
    pSrcString1 : POINTER TO STRING;
    pSrcString2 : POINTER TO STRING;
    pDstString  : POINTER TO STRING;
    nDstSize    : UDINT;
END_VAR

Name	Typ	Beschreibung
pSrcString1	POINTER TO STRING	Zeiger auf die erste der zu verkettenden STRING-Variable (Eingabe-Zeichenfolge)
pSrcString2	POINTER TO STRING	Zeiger auf die erste der zu verkettenden STRING-Variable (Eingabe-Zeichenfolge)
pDstString	POINTER TO STRING	Zeiger auf die resultierende STRING-Variable nach der Verkettung (Ausgabe-Zeichenfolge)
nDstSize	UDINT	Größe der resultierenden STRING-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