F77_DBIN2A

Converts the 32-bit data specified by s1 to ASCII code that expresses the equivalent decimals. The converted result is stored in the area starting from the 16-bit area specified by d_Start as specified by s2_Number. s2_Number specifies the number of bytes used to express the destination data using decimal.

Parameters

Input

s1 (DWORD, DINT, UDINT, DATE, TOD, DT)

32-bit data area to be converted (source)

s2_Number (INT)

specifies number of bytes to express destination data (ASCII codes)

Output

d_Start (WORD)

16-bit area for storing ASCII codes (destination)

Remarks

• Instead of using this F instruction, we recommend using the corresponding FP7 instruction: FP_DEC_TO_ASCII

• When a positive number is converted, the "+" sign is not converted.

• When a negative number is converted, the "-" sign is also converted to ASCII code (ASCII HEX code: 16#2D).

• If the area specified by s2_Number is more than that required by the converted data, the ASCII code for "SPACE" (ASCII HEX code: 16#20) is stored in the extra area.

• Data is stored in the direction of the last address, so the position of the ASCII code may change depending on the size of the data storage area.

• If the number of bytes of ASCII codes following conversion (including the minus sign) is larger than the number of bytes specified by the s2_Number, an operation error occurs. Make sure the sign is taken into consideration when specifying the object of conversion for the s2_Number.

• Example of converting a negative number from 32–bit decimal format to ASCII codes

  

  1.  (1) 32-bit data
  2.  (2) Converted result
  3.  (3) F77_DBIN2A instruction execution
  4.  (4) Code
  5.  (5) Extra byte
  6.  (6) Range specified by s2 (10 bytes)

• Decimal characters to express ASCII HEX code:

  Decimal characters	ASCII HEX code
  SPACE + - 0 1 2 3 4 5 6 7 8 9	16#20 16#2B 16#2D 16#30 16#31 16#32 16#33 16#34 16#35 16#36 16#37 16#38 16#39

Error flags

sys_bIsOperationErrorHold (turns to TRUE and remains TRUE)

• if the number of bytes specified by s2_Number exceeds the area specified by d_Start.

• if the data specified by s2_Number is recognized as "0".

• if the converted result exceeds the area specified by d_Start.

• if the number of bytes of converted result exceeds the number of bytes specified by s2_Number.

sys_bIsOperationErrorNonHold (turns to TRUE for one scan)

• if the number of bytes specified by s2_Number exceeds the area specified by d_Start.

• if the data specified by s2_Number is recognized as "0".

• if the converted result exceeds the area specified by d_Start.

• if the number of bytes of converted result exceeds the number of bytes specified by s2_Number.