LGF_DecodeUtf8 (FC / V1.0.0)

Übersicht

Autor: Siemens Online Support

Kurzbeschreibung

Dekodiert einen UTF-8 kodierten Byte-Stream in einen WString

Baustein Schnittstelle

LGF_DecodeUtf8 (FC)
Array[*] of Byte  byteStream Ret_Val  Word
    
DInt  startPos   
    
UInt  count   
    
WString  decodedString  WString
       
   

Input Parameter

BezeichnerDatentyp Beschreibung
byteStreamArray[*] of Byte UTF-8 kodierter Bytestrom
startPosDInt Position im Bytestrom, von der aus die Dekodierung beginnen soll
countUInt Anzahl der zu dekodierenden Zeichen (nicht Bytes); 0: Bytestrom wird bis zum Ende dekodiert

Output Parameter

BezeichnerDatentyp Beschreibung
Ret_ValWord 16#0000 - 16#7FFF: Status des FC, 16#8000 - 16#FFFF: Fehleridentifikation

In/Out Parameter

BezeichnerDatentyp Beschreibung
decodedStringWString Dekodierter String

Status & Error Meldungen

Code / WertBezeichner / Beschreibung
16#0000STATUS_NO_ERROR
Status: Kein Fehler
16#7FFDWARN_UNSUPPORTED_CHAR
Warnung: Bytestrom wurde dekodiert, enthält aber nicht unterstützte Zeichen
16#7FFEWARN_STREAM_EXCEEDS_MAX_LEN
Warnung: Bytestream überschreitet die maximale Länge des Strings beim Parameter `decodedString`
16#8201ERR_START_POS_OUTSIDE
Fehler: Parameter `startPos` liegt außerhalb der Array-Grenzen
16#8202ERR_COUNT_EXCEEDS_BOUNDS
Fehler: Parameter `count` liegt außerhalb der Array-Grenzen
16#8203ERR_COUNT_EXCEEDS_MAX_LEN
Fehler: Parameter `count` überschreitet die max. Länge eines WString

Änderungshistorie

Version & DatumÄnderungsbeschreibung
01.00.00Online Support
2022-12-16First released version