sLiteral_TO_UTF8

Die Funktion konvertiert eine beliebige Zeichenfolge vom Datentyp STRING 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 sLiteral_TO_UTF8 : STRING(511)

VAR_IN_OUT CONSTANT
    sLiteral   : STRING;
END_VAR

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

{attribute 'TcEncoding' := 'UTF-8'}
sMyText1 : STRING := sLiteral_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‘.