UTF8_TO_STRING

UTF8_TO_STRING 1:

The function converts a string in UTF-8 format (pointer variable of the data type PVOID) into a string (variable) of the data type STRING.

The function returns

If the input string is longer than the output string, the string will be truncated. Unknown characters are skipped.

The function stops the conversion after Tc2_Utilities.Parameterlist.cMaxCharacters. With appropriate parameterization an infinite loop can be avoided.

FUNCTION UTF8_TO_STRING : BOOL

The return value is TRUE if the conversion was successful.

UTF8_TO_STRING 2: Inputs

VAR_INPUT
    pDstSTRING : POINTER TO STRING;
    pSrcUTF8   : PVOID;
    nDstSize   : UDINT;
END_VAR

Name

Type

Description

pDstSTRING

POINTER TO STRING

Pointer to the converted STRING variable (output string)

pSrc UTF8

PVOID

Pointer variable (input string)

nDstSize

UDINT

Size of the resulting STRING variable (output string) in bytes; the SIZEOF() operator can be used for the assignment.

UTF8_TO_STRING 3: Outputs

VAR_OUTPUT
    nDstLen        : UDINT;
END_VAR

Name

Type

Description

nDstLen

UDINT

Actual length of the output string as number of characters

UTF8_TO_STRING 4:

Documentation for attribute 'TcEncoding' := 'UTF-8'

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

Requirements

Development environment

Target platform

PLC libraries to be integrated (category group)

TwinCAT v3.1.4022

PC or CX (x86, x64, ARM)

Tc2_Utilities (System) >= 3.3.21.0