wsLiteral_TO_UTF8

Die Funktion konvertiert eine beliebige Zeichenfolge vom Datentyp WSTRING in eine Zeichenfolge im UTF-8-Format. Die Funktion ist insbesondere für die Zuweisung von Literalen geeignet.

Bei der Zuweisung von Literalen zu einem UTF-8 STRING gilt:

• Literale, die nur den ASCII-Zeichensatz nutzen, können direkt zugewiesen werden.
• Literale, die den STRING-Zeichensatz nutzen, können mittels sLiteral_TO_UTF8() zugewiesen werden.
• Literale, die den WSTRING-Zeichensatz nutzen, können mittels wsLiteral_TO_UTF8() zugewiesen werden.

Wenn das Literal länger ist als die mögliche Ausgabe-Zeichenfolge, wird ein Leerstring zurückgeliefert.

FUNCTION wsLiteral_TO_UTF8 : STRING(511)

VAR_IN_OUT CONSTANT
    wsLiteral   : WSTRING;
END_VAR

{attribute 'TcEncoding' := 'UTF-8'}
sMyText : STRING := wsLiteral_TO_UTF8("Hühner legen Eier.");

{attribute 'TcEncoding' := 'UTF-8'}
sMyText2 : STRING := wsLiteral_TO_UTF8("The dinner costs 30 €.");

Dokumentation zum Attribut 'TcEncoding' := 'UTF-8' Für weitere Informationen zu Zeichenfolgen im UTF-8 Format siehe auch die Dokumentation zum Attribut ‚TcEncoding‘.