# LGF_StringToTaddr (FC / 3.0.1)

Übersicht

Autor: Siemens Digital Industry

## Kurzbeschreibung

Der Systemdatentyp `TADDR_Param` enthält Adressinformation, bestehend aus einer IPV4-Adresse und der Port-Nummer.

Die Funktion `LGF_StringToTaddr` konvertiert eine Variable vom Datentyp `String` in eine Variable des Systemdatentyp `TADDR_Param`.

### Baustein Schnittstelle

| LGF_StringToTaddr (FC) |
--- | --- | ---
String |  |  | ipAddressString |  | Ret_Val |  |  | TADDR_Param
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
ipAddressString | String | IPV4-Adress String im Format `192.168.1.200:55047` [Port Nummer inklusive Doppelpunkt `:` ist optional]

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | TADDR_Param | IP-Adresse und Port Nummer als `TADDR_Param` Datentyp
error | Bool | FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status | Word | 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_FINISHED_NO_ERROR Status: Abarbeitung ohne Fehler beendet
16#8110 | ERR_OCTET_WRONG_NUMBER_OF_CHAR Fehler: Zu viele Zeichen im X'ten Oktett der IP-Adresse
16#8120 | ERR_OCTET_STRING_IS_EMPTY Fehler: Keine Nummer / Zeichen im X'ten Oktett der IP-Adresse - leerer String
16#8130 | ERR_OCTET_EXCEEDS_MAX_IP_ADDRESS Fehler: Nummer im Oktett überschreitet den max. möglichen Bereich (255)
16#8150 | ERR_PORT_WRONG_NUMBER_OF_CHAR Fehler: Zu viele Zeichen bei der Konvertierung des Port-Strings
16#8151 | ERR_PORT_STRING_IS_EMPTY Fehler: Keine Nummer/ Zeichen im Port-String. Port-String ist leer
16#8152 | ERR_PORT_EXCEEDS_MAX_PORT Fehler: Port-Nummer überschreitet den max. möglichen Bereich (65535)

## Funktionsbeschreibung

Die Funktion konvertiert die IPV4-Adresse mit oder ohne Portnummer vom Datentyp `String` nach `TADDR_Param`.
Der String muss der folgenden Form entsprechen:

- ohne Portnummer: `[0..255].[0..255].[0..255].[0..255]`
- mit Portnummer: `[0..255].[0..255].[0..255].[0..255]:[0..65535]`

### Beispiel:

- Das Standard String Format für eine IPV4 Adresse ohne Port Nummer:
  `192.168.11.11`
- Das Standard String Format für eine IPV4 Adresse mit Port Nummer:
  `192.168.11.11:3294`

Hinweis
  Wenn Sie im Parameter `ipAddressString` keine Portnummer angeben, gibt der Parameter `Ret_Val.REM_PORT_NR` den Wert `0` aus.

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Industry Online Support
| 30.01.2017 | First released version
| 1.0.1 | Siemens Industry Online Support
| 17.08.2018 | Upgrade: TIA V15 Update 2
| 1.0.2 | Siemens Industry Online Support
| 23.11.2018 | Upgrade: TIA V15.1
| 1.0.3 | Simatic Systems Support
| 10.06.2019 | Standard header and block parameters update
| 1.0.4 | Simatic Systems Support
| 10.07.2019 | Code refactoring and performance improvements
| 1.0.6 | Simatic Systems Support
| 14.11.2019 | Add ENO handling
| 3.0.0 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0 Harmonize the version of the whole library
| 3.0.1 | Simatic Systems Support
| 23.02.2021 | Insert documentation