DATA_TO_HEXSTR2
The function converts binary data into a hexadecimal string. This function can be used to convert simple data types and structure variables. If the maximum possible length of the output is exceeded, a dot character is added to the result string ('.') and the conversion is aborted. The remaining data bytes are not converted.
FUNCTION DATA_TO_HEXSTR2 : UDINT
VAR_INPUT
VAR_INPUT
pSrcData : POINTER TO BYTE; // pointer to data buffer
nSrcSize : UDINT; // size of data buffer in bytes (= number of bytes to be converted)
pDstHexStr : POINTER TO STRING;// pointer to destination buffer
nDstSize : UDINT; // size of destination buffer in bytes
bLoCase : BOOL; // default: use "ABCDEF", if TRUE use "abcdef" characters
END_VAR
pSrcData: Start address (pointer) for the binary data to be converted. The address can be determined with the ADR operator.
nSrcSize: Max. size (in bytes) of the binary data to be converted. The size can be determined with the SIZEOF operator.
pDstHexStr: Start address (pointer) to the destination buffer into which the converted hexadecimal string is to be written. The address can be determined with the ADR operator.
nDstSize: Max. available size (in bytes) of the destination buffer. The size can be determined with the SIZEOF operator.
bLoCase: This parameter determines whether upper or lower case letters are to be used in the conversion. TRUE = lower case letters, FALSE = upper case letters.
Requirements
Development environment | Target platform | PLC libraries to be integrated (category group) |
---|---|---|
TwinCAT v3.1.4024.0 | PC or CX (x86, x64, ARM) | Tc2_Utilities (System) >= 3.5.1.0 |