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
VAR_INPUT
VAR_INPUT
pSrcString : POINTER TO STRING;
pInsertString : POINTER TO STRING;
pDstString : POINTER TO STRING;
nDstSize : UDINT;
nPos : UDINT;
END_VAR
pSrcString: Zeiger auf die STRING-Variable, deren Zeichenfolge durchsucht werden soll (Eingabe-Zeichenfolge)
pInsertString: Zeiger auf die STRING-Variable, deren Zeichenfolge in die andere Zeichenfolge eingefügt werden soll (Eingabe-Zeichenfolge)
pDstString: Zeiger auf die resultierende STRING-Variable (Ausgabe-Zeichenfolge)
nDstSize: Größe der resultierenden STRING-Variablen (Ausgabe-Zeichenfolge) in Bytes. Bei der Zuweisung kann der Operator SIZEOF() verwendet werden.
nPos: 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 |