num_to_string

PLCopen motion icon

Function - Converts a number into a string value.

Inputs

Input	Data Type	Description
IN	ANY	Input number.
Width	DINT	Length of the output string.
Digits	DINT	Number of digits after decimal point.

Output	Data Type	Range	Unit	Description
Q	STRING			Value converted to string.

This function converts any numerical value to a string.

It allows a specific length and a number of digits after the decimal points.

If WIDTH is 0 (zero), the string is formatted with the necessary length.
```
Q := NUM_TO_STRING (1.333333, 0, 2);    (* Q is '1.33' *)
```
If WIDTH is greater than 0 (zero), the string is completed with leading blank characters in order to match the value of WIDTH.
```
Q := NUM_TO_STRING (123.4, 8, 2);    (* Q is '   123.40' *)
```
If WIDTH is greater than 0 (zero), the string is completed with trailing blank characters in order to match the value of WIDTH.
```
Q := NUM_TO_STRING (123.4, -8, 2);    (* Q is '123.40  ' *)
```
If DIGITS is 0 (zero) then neither decimal part nor decimal point are added.
```
Q := NUM_TO_STRING (1.333333, 3, 0);    (* Q is '   1' *)
```
If DIGITS is greater than 0 (zero), the corresponding number of decimal digits are added. '0' digits are added if necessary
```
Q := NUM_TO_STRING (1.333333, 0, 1);    (* Q is '1.3' *)
```
If the value is too long for the specified width, the string is filled with '*' characters.
```
Q := NUM_TO_STRING (1234, 3, 0);    (* Q is '***' *)
```