sLiteral_TO_UTF8

This function converts any character string of the data type STRING into a character string in UTF-8 format. The function is particularly suitable for the assignment of literals.

When assigning literals to a UTF-8 STRING, the rules are:

• Literals that only use the ASCII character set can be directly assigned.
• Literals that use the STRING character set can be assigned by means of sLiteral_TO_UTF8().
• Literals that use the WSTRING character set can be assigned by means of wsLiteral_TO_UTF8().

An empty string will be returned if the literal is longer than the possible output character string.

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 €.');

Documentation for attribute 'TcEncoding' := 'UTF-8' For more information about strings in UTF-8 format see also the documentation on the 'TcEncoding' attribute.