FB_BACnet_StringExtDecode

Application

Function block for decoding BACnet strings. The following codings are supported: ASCII/UTF-8, UCS2, UCS4 and ISO8859-1. The output is in Windows-1252.

VAR_INPUT

pChrStringExt  : POINTER TO ST_BACnet_CharacterStringExt;
pOutString     : POINTER TO T_MaxString;
cbOutSize      : UDINT;

pChrStringExt: BACnet character string data structure (property value) with header and string.

pOutString: Pointer to the output STRING (Windows-1252-coded output).

cbOutSize: Byte length of the output string (maximum writeable length).

VAR_OUPUT

bValid         : BOOL;
bOverflow      : BOOL;
bUnsupported   : BOOL;
nLength        : UDINT;
eSrcEncoding   : E_BACNETSTRINGENCODINGTYPES;

bValid: Decoding was successful.

bOverflow: Input string is too long to be written to the output STRING.

bUnsupported: The input string contains a character set that is not supported.

nLength: Character length of the output STRING. The number of actually written characters.

eSrcEncoding: Detected input character set.