# LGF_FindStringInCharArray (FC / 1.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

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.

## Ä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