|
Type
| Function |
|
Description
| Converts an unsigned integer value into a binary coded decimal value (BCD value) of the data type WORD.
The function is an overloaded function. It can operate on all unsigned input data types (UDINT, UINT, ULINT and USINT). |
|
Parameters
| Input
 IN
The function can process the UDINT, UINT, ULINT and USINT unsigned integer values at its input.
Output
OUT
|
|
Conversion rules
| In a BCD WORD, integer values between 0 and 9999 can be stored. Each digit is represented by four bits. If the input value has more than 4 digits (exceeds the maximum value of the BCD WORD), the function returns the maximum value 16#FFFF. |
|
Examples
| Examples in ST
out := TO_BCD_WORD(USINT#14); (* results in 16#0014 *)
out := TO_BCD_WORD(ULINT#9999); (* results in 16#9999 *)
out := TO_BCD_WORD(ULINT#10000); (* results in 16#FFFF *)
|
|
Error behavior
| Error behavior
The following table shows the errors which may occur while executing the function and the value returned by the function in the corresponding error case.
| Error case | Output value |
| Overflow | LIMIT (maximum value) |
|
|
Additional information
| EN/ENO behavior
The POU is only executed if TRUE is applied to the EN input. If EN = FALSE, the POU is not executed and ENO = FALSE indicates the inactivity.
If any of the errors listed under "Error behavior" occurs while executing the function, ENO is set to FALSE.
|