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

Eingänge

VAR_INPUT
    pSrcString    : POINTER TO STRING;
    pInsertString : POINTER TO STRING;
    pDstString    : POINTER TO STRING;
    nDstSize      : UDINT;
    nLen          : 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 die Zeichen ersetzen 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.
nLen	UDINT	Anzahl der Zeichen, die ersetzt werden sollen.
nPos	UDINT	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