Die Funktion sucht nach einer angegebenen Zeichenkette innerhalb eines Arrays von Zeichen.
Sie gibt die Position der Zeichenkette im Array zurück, wenn die Zeichenkette nicht gefunden wird, ist der Rückgabewert -1.
Baustein Schnittstelle
LGF_FindStringInCharArray (FC)
String
searchFor
Ret_Val
DInt
DInt
startPos
status
Word
Variant
searchIn
Variant
Input Parameter
Bezeichner
Datentyp
Beschreibung
searchFor
String
Text, nach dem gesucht wird
startPos
DInt
Position innerhalb des Arrays ab der die Suche beginnen soll (Index null basiert)
Output Parameter
Bezeichner
Datentyp
Beschreibung
Ret_Val
DInt
Position (Index) des ersten Zeichens des gesuchten Textes innerhalb des Eingabe-Arrays (Index null basiert). Gibt `-1` zurück, wenn nichts gefunden wurde.
status
Word
16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
In/Out Parameter
Bezeichner
Datentyp
Beschreibung
searchIn
Variant
Array von Character oder Byte in dem gesucht wird.
Status & Error Meldungen
Code / Wert
Bezeichner / Beschreibung
16#0000
STATUS_NO_ERROR Status: Abarbeitung ohne Fehler beendet
16#8200
ERR_NO_ARRAY Fehler: Am Eingang `searchIn` liegt kein Array von Character oder Byte an.