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
VAR_INPUT
VAR_INPUT
pSrcString1 : POINTER TO STRING;
pSrcString2 : POINTER TO STRING;
pDstString : POINTER TO STRING;
nDstSize : UDINT;
END_VAR
pSrcString1: Zeiger auf die erste der zu verkettenden STRING-Variable (Eingabe-Zeichenfolge)
pSrcString2: Zeiger auf die zweite der zu verkettenden STRING-Variable (Eingabe-Zeichenfolge)
pDstString: Zeiger auf die resultierende STRING-Variable nach der Verkettung (Ausgabe-Zeichenfolge)
nDstSize: 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 |