LGF_EncodeUtf8 (FC / V1.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

BezeichnerDatentyp Beschreibung
sourceStringWString Zeichen, das nach UTF-8 konvertiert werden soll
startPosDInt Position im Byte Stream, um die encodierten WChars einzufügen
(Array Untergrenze wird aufaddiert)

Output Parameter

BezeichnerDatentyp Beschreibung
Ret_ValWord 16#0000 - 16#7FFF: Status des FC, 16#8000 - 16#FFFF: Fehlererkennung
bytesUsedUInt Anzahl der umgewandelten Bytes. Der Bereich reicht von 1 bis 3.

In/Out Parameter

BezeichnerDatentyp Beschreibung
encodedByteStreamArray[*] 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 / WertBezeichner / Beschreibung
16#0000STATUS_NO_ERROR
Status: Kein Fehler
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

Änderungshistorie

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