LGF_FindStringInCharArray (FC / V1.1.0)

Übersicht

Autor: Siemens Online Support

Kurzbeschreibung

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

BezeichnerDatentyp Beschreibung
searchForString Text, nach dem gesucht wird
startPosDInt Position innerhalb des Arrays ab der die Suche beginnen soll (Index null basiert)

Output Parameter

BezeichnerDatentyp Beschreibung
Ret_ValDInt Position (Index) des ersten Zeichens des gesuchten Textes innerhalb des Eingabe-Arrays (Index null basiert).
Gibt `-1` zurück, wenn nichts gefunden wurde.
statusWord 16#0000-16#7FFF: Status des FB
16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

In/Out Parameter

BezeichnerDatentyp Beschreibung
searchInVariant Array von Character oder Byte in dem gesucht wird.

Status & Error Meldungen

Code / WertBezeichner / Beschreibung
16#0000STATUS_NO_ERROR
Status: Abarbeitung ohne Fehler beendet
16#8200ERR_NO_ARRAY
Fehler: Am Eingang `searchIn` liegt kein Array von Character oder Byte an.

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Siemens Online Support
01.04.2019First released version (LHttp)
01.01.00Siemens Online Support
10.06.2022Adaption and integration into LGF