# LGF_ExtractStringFromCharArray (FC / 1.1.0)

Übersicht

Autor: Siemens Online Support

## Kurzbeschreibung

Die Funktion extrahiert eine Zeichenkette, die durch einen Text davor und danach angegeben wird, aus einem Array von Zeichen.

### Baustein Schnittstelle

| LGF_ExtractStringFromCharArray (FC) |
--- | --- | ---
String |  |  | textBefore |  | Ret_Val |  |  | Word
String |  |  | textAfter |  | extractedString |  |  | String
|  |  |  |  | status |  |  | Word
Variant |  |  | searchIn |  |  | Variant

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
textBefore | String | Text vor den zu extrahierenden Zeichen
textAfter | String | Text hinter den Zeichen, die extrahiert werden müssen

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | Word | 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)
extractedString | String | Extrahierte Zeichenfolge
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_TEXT_FOUND Erfolgreich, Starttext und Endtext wurden gefunden
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.
16#9001 | WARNING_ONLY_START Nicht erfolgreich, nur der Anfangstext wurde gefunden, der extrahierte String ist mit Zeichen nach dem Anfangstext gefüllt
16#9002 | WARNING_NOTHING_FOUND Erfolglos, kein Text wurde gefunden

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Online Support
| 01.04.2019 | First released version (LHttp)
| 1.1.0 | Siemens Online Support
| 10.06.2022 | Adaption and integration into LGF