parseint (number)
  • 23 May 2023
  • Dark
    Light
  • PDF

parseint (number)

  • Dark
    Light
  • PDF

Article summary

parseInt Task Purpose

The parseInt task parses a string value and returns an integer (number) value using the decimal number system as a mathematical base. Only the first number in the string is returned. If the string argument is not a string, then it is converted to a string (using the ToString abstract operation). Leading whitespaces in the string are ignored.

Potential Use Case

This task is useful when you need to convert a number represented as a string into an integer. Let's say your data string contains a decimal value such as "1.655". With parseInt, the decimal value will convert to the rounded number '1', and the digits that follow the decimal will be truncated.

Properties

Input and output properties are shown below.

Input Type Description
str String Required. The string value to parse and return as a number.
radix Number Optional. Represents the numerical system used to convert str to an integer. This can be a value between 2 and 36.
Note: If no radix is provided, the default will be 10 (decimal).


Output Type Description
result Number The number that returns when the input str is parsed.
If the first character cannot be converted to a number, the result returns NaN.

Example 1

In the IAP example shown below:

  • The incoming string variable str is statically set to 0xF, which is a hexidecimal representation.

  • The radix number is set to 16, which is a hexidecimal number.

    parseInt-01

  • The result of the outgoing variable is 15.

    parseInt-02

Example 2

In the IAP example shown below:

  • The incoming string variable str is statically set to 02019 4 29. Notice the white spaces within the reference variable.

  • No radix number is provided, so the default decimal value (10) is used.

    parseInt-03

  • The result of the outgoing variable is 2019.

    parseInt-04

Example 3

In the IAP example shown below:

  • The incoming string variable str is statically set to 5.99.

  • No radix number is provided, so the default decimal value (10) is used.

    parseInt-05

  • The result of the outgoing variable is 5. The numbers after the decimal are truncated.

    parseInt-06

Example 4

In the IAP example shown below:

  • The incoming string variable str is statically set to 7,123. Notice the value for the reference variable contains a comma.

  • No radix number is provided, so the default decimal value (10) is used.

    parseInt-07

  • The result of the outgoing variable is 7. The numbers after the comma are truncated.

    parseInt-08

Example 5

In the IAP example shown below:

  • The incoming string variable str is set to 20*4. Notice the operator (asterik) within the reference variable.

  • No radix number is provided, so the default decimal value (10) is used.

    parseInt-09

  • The result of the outgoing variable is 20.

    parseInt-10


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.