UNION_BACNET_STRING (UNION)

TYPE UNION_BACNET_STRING : UNION

Structure for representing the BACnetCharString type

A Character String is a BACnet primitive datatype. Any BACnet character string can be stored in the BACNET_CHAR_STRING datatype. A Property Contents containing this datatype will have its tag equal to DATA_TYPE_CHAR_STRING. A BACnet character string can be one of the five character sets described below. The enumeration datatype BACNET_STRING_TYPE is used to represent each BACnet character set. In addition, BACNET_STRING_TYPE may have a STRING_NONE value, which is used to indicate the absent of an optional string.

The string delimiter is added by ASN decoder for convenience, but the application does not have to rely on it to determine the total length of the string, because the total size of the string in bytes is ready available in nBufferSize.n

NOTE: The stack API expects the string to be in the right encoding. It doesn’t make any character or codepage conversions here.

InOut:

Name	Type	Comment
chstringData	POINTER TO BYTE	Pointer to buffer for type BACNET_STRING_UTF_8, BACNET_STRING_JIS_C_6226 and BACNET_STRING_ISO_8859_1
wstringData	POINTER TO IEC_BACNET_WORD	Pointer to buffer for type BACNET_STRING_DBCS and BACNET_STRING_UCS_2
dwstringData	POINTER TO IEC_BACNET_DWORD	Pointer to buffer for type BACNET_STRING_UCS_4