# LGF_EncodeUtf8 (FC / 1.0.0)

Übersicht

Autor: Siemens Online Support

## Kurzbeschreibung

Kodiert ein WString in einen UTF-8 kodierten Bytestrom.

### Baustein Schnittstelle

| LGF_EncodeUtf8 (FC) |
--- | --- | ---
WString |  |  | sourceString |  | Ret_Val |  |  | Word
DInt |  |  | startPos |  | bytesUsed |  |  | UInt
Array[*] of Byte |  |  | encodedByteStream |  |  | Array[*] of Byte

### Input Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
sourceString | WString | Zeichen, das nach UTF-8 konvertiert werden soll
startPos | DInt | Position im Byte Stream, um die encodierten WChars einzufügen (Array Untergrenze wird aufaddiert)

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | Word | 16#0000 - 16#7FFF: Status des FC, 16#8000 - 16#FFFF: Fehlererkennung
bytesUsed | UInt | Anzahl der umgewandelten Bytes. Der Bereich reicht von 1 bis 3.

### In/Out Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
encodedByteStream | Array[*] of Byte | UTF-8-konforme Bytefolge. B0 speichert das erste Byte, B1 das zweite und B2 das dritte Byte. B3 wird nicht verwendet

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_NO_ERROR Status: Kein Fehler
16#8201 | ERR_START_POS_OUTSIDE Fehler: Parameter `startPos` liegt außerhalb der Array-Grenzen
16#8202 | ERR_COUNT_EXCEEDS_BOUNDS Fehler: Parameter `count` liegt außerhalb der Array-Grenzen

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 1.0.0 | Siemens Online Support
| 2022-12-16 | First released version