REPLACE2
Die Funktion ersetzt nLen Zeichen einer Zeichenfolge durch eine andere Zeichenfolge beginnend an der Position nPos.
Die Funktion liefert
- TRUE, wenn die Zeichen erfolgreich ersetzt wurden.
- 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 REPLACE2 : BOOL
VAR_INPUT
VAR_INPUT
pSrcString : POINTER TO STRING;
pInsertString : POINTER TO STRING;
pDstString : POINTER TO STRING;
nDstSize : UDINT;
nLen : 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 die Zeichen ersetzen 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.
nLen: Anzahl der Zeichen, die ersetzt werden sollen
nPos: Position des Zeichens, das einschließlich der nachfolgenden Zeichen entfernt werden soll (nPos = 1 = erstes Zeichen)
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS-Bibliotheken (Kategoriegruppe) |
|---|---|---|
TwinCAT v3.1.4022 | PC oder CX (x86, x64, ARM) | Tc2_Utilities (System) >= 3.3.35.0 |