Purpose
The numberToString task is used to convert a number to a string. Based on the optional radix parameter, the output returns a string that represents the specified number object. This task method is the opposite of the parseInt task used to convert a string value to a number. Lastly, the numberToString task does not change the value of the original number.
Note: The
radixspecifies the number of unique digits in the numeral system, including 0. For example, a radix of 10 would represent the Decimal system because the Decimal system uses ten digits from 0 through 9. Whereas, a radix of 2 would represent the Binary system because the Binary system uses only two digits which are 0 and 1. A radix of 8 represents the Octal system, and a radix of 16 represents the Hexadecimal system.
Potential Use Cases
Sometimes you may need to construct a string that contains a number from another variable. You could potentially use this task to handle a field of numerical data that needs to be converted to a string first before exporting to a text file. Moreover, let's say you have implemented specific calculations and wish to display the computed numbers as text in a financial statement. To do this, you could use numberToString and convert the numbers to a string.
Properties
Input and output properties are shown below.
| Input | Type | Description |
|---|---|---|
num |
Number | Required. |
radix |
Number | Optional. A number in the range of 2 through 36 specifying the mathematical base to use for representing a numeric value. If no radix is provided, the default will be 10 (a decimal number). |
| Output | Type | Description |
|---|---|---|
numToString |
String | A string representing the specified number object. |
Examples
Example 1
In this IAP example, the incoming num variable is statically set to 255 and the radix number is omitted, so the default will be a decimal number (10).
The numToString value that returns in the outgoing variable is "255". Notice the number is a literal string enclosed within double quotation marks.
Example 2
In this IAP example, the radix of 2 represents the Binary system, which means the num variable of 255 will be converted to a Binary number.
The numToString value that returns is "11111111".
Example 3
With this example the radix of 8 represents the Octal system, which means the num variable of 255 will be converted to an Octal.
The numToString value that returns is "377".
Example 4
With this example the radix of 16 represents the Hexidecimal system, which means the num variable of 255 will be converted to a Hexidecimal number.
The numToString value that returns is "ff".
