FC_ArrayOfByteToString

FC_ArrayOfByteToString - General Information

Overview

Type:	Function
Available as of:	V1.0.3.0
Versions:	Current version

Task

Convert the array of byte values to a String.

Description

The function converts an array of byte values into a String(80). In the process, the byte values are interpreted and converted according to the ASCII table.

Interface

Input	Data type	Description
i_abyByteIn	ARRAY[1..80] OF BYTE	Byte values to be converted
i_xByteOrder	BOOL	High byte and low byte are swapped
i_xInsertSpace	BOOL	The character indicating the string end (0x00) is replaced by a space (0x20)

Output	Data type	Description
q_etDiag	GD.ET_Diag	General library-independent statement on the diagnostic. A value not equal to ET_Diag.Ok corresponds to an diagnostic message.
q_etDiagExt	ET_DiagExt	POU-specific output on the diagnostic. q_etDiag = ET_Diag.Ok -> Status message q_etDiag <> ET_Diag.Ok -> Diagnostic message

Output

Data type

Description

q_etDiag

GD.ET_Diag

General library-independent statement on the diagnostic.

A value not equal to ET_Diag.Ok corresponds to an diagnostic message.

q_etDiagExt

ET_DiagExt

POU-specific output on the diagnostic.

q_etDiag = ET_Diag.Ok -> Status message

q_etDiag <> ET_Diag.Ok -> Diagnostic message

Return Value

Data type	Description
STRING[80]	The ASCII content of the array i_abyByteIn

Example

VAR
abyASCII : ARRAY[1..80] OF BYTE := 72,65,76,76,79;
sString : STRING[80];
END_VAR

sString := FC_ArrayOfByteToString(i_abyByteIn := abyASCII, i_xByteOrder := TRUE, i_xInsertSpace :=FALSE);

sString = 'HALLO'

Diagnostic Messages

q_etDiag	q_etDiagExt	Enumeration value	Description
OK	Ok	0	Ok

Enumeration name:	Ok
Enumeration value:	0
Description:	Ok

The conversion has been completed successfully.