wsLiteral_TO_UTF8

This function converts any character string of the data type WSTRING 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 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 €.");

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