LGF_ExtractStringFromCharArrayAdv (FC / V1.1.0)

Übersicht

Autor: Siemens Online Support

Kurzbeschreibung

Extrahiert eine Zeichenkette, die durch einen Text davor und danach angegeben ist, aus einer Reihe von Zeichen mit erweiterten Optionen.

Baustein Schnittstelle

LGF_ExtractStringFromCharArrayAdv (FC)
String  textBefore Ret_Val  Word
    
String  textAfter extractedString  String
    
Bool  includeBeforeAfter position  DInt
    
DInt  startPos length  Int
    
   status  Word
    
Variant  searchIn  Variant
       
   

Input Parameter

BezeichnerDatentyp Beschreibung
textBeforeString Text vor den Zeichen, die extrahiert werden sollen
textAfterString Text hinter den Zeichen, der extrahiert werden muss
includeBeforeAfterBool TRUE: `TextBefore` und `TextAfter` sind in der extrahierten Zeichenkette enthalten
startPosDInt Position innerhalb des Arrays ab der die Suche beginnen soll (Index null basiert)

Output Parameter

BezeichnerDatentyp Beschreibung
Ret_ValWord Rückgabewert: 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
extractedStringString Extrahierte Zeichenkette
positionDInt Position (Index) innerhalb des Arrays, an der der Text beginnt (Index null basiert)
lengthInt Länge des Textes, der extrahiert 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_TEXT_FOUND
Erfolgreich, Starttext und Endtext wurden gefunden
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.
16#9001WARNING_ONLY_START
Nicht erfolgreich, nur der Anfangstext wurde gefunden, der extrahierte String ist mit Zeichen nach dem Anfangstext gefüllt
16#9002WARNING_NOTHING_FOUND
Erfolglos, kein Text wurde gefunden

Ä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