INSERT2

Die Funktion fügt eine Zeichenfolge in eine andere Zeichenfolge nach der Position nPos ein. Wenn nPos = 0 ist, wird die Zeichenfolge vor dem ersten Zeichen der anderen Zeichenfolge eingefügt.

Die Funktion liefert

TRUE, wenn die Zeichenfolge erfolgreich eingefügt wurde.
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 INSERT2 : BOOL

Eingänge

VAR_INPUT
    pSrcString    : POINTER TO STRING;
    pInsertString : POINTER TO STRING;
    pDstString    : POINTER TO STRING;
    nDstSize      : UDINT;
    nPos          : UDINT;
END_VAR

Name	Typ	Beschreibung
pSrcString	POINTER TO STRING	Zeiger auf die STRING-Variable, deren Zeichenfolge durchsucht werden soll (Eingabe-Zeichenfolge).
pInsertString	POINTER TO STRING	Zeiger auf die STRING-Variable, deren Zeichenfolge in die andere Zeichenfolge eingefügt werden soll (Eingabe-Zeichenfolge).
pDstString	POINTER TO STRING	Zeiger auf die resultierende STRING-Variable (Ausgabe-Zeichenfolge)
nDstSize	UDINT	Größe der resultierenden STRING-Variablen (Ausgabe-Zeichenfolge) in Bytes, bei der Zuweisung kann der Operator SIZEOF() verwendet werden.
nPos	UDINT	Position des Zeichens, hinter dem die Zeichenfolge eingefügt werden soll.

Voraussetzungen

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