Siebel eScript Language Reference > Methods Reference > Conversion Methods >

Convert Value to Integer 32 Method

The Convert Value to Integer 32 method converts the value that the value argument contains to an integer in the range of negative 2³¹ through 2³¹ minus 1. The equivalent nonexponential range is negative 2,147,483,648 through 2,147,483,647. It returns a value depending on which of the following values the value argument contains:

• NaN. It returns the following value:

  NaN

• +0 or -0. It returns the following value:

  0

• POSITIVE_INFINITY or NEGATIVE_INFINITY. It returns the following value:

  Infinity

• A number. It rounds the integer part of this number toward zero, and then returns the integer.

This method is unique to Siebel eScript. For more information, see Make Sure the JavaScript Interpreter Can Run a Function and NaN Numbers.

Format

ToInt32(value)

Table 96 describes the arguments for the Convert Value to Integer 32 method.

Usage

To avoid an error, you must first pass the value that the value argument contains to the Is NaN method or to the Convert Value to Number method. To use the Is NaN method, you include a statement that uses the following format:

if (isNaN(value))
.
.   [error-handling statements];
.
else
   ToInt32(value);

The Convert Value to Integer 32 method truncates rather than rounds the value it receives, so it rounds numbers toward 0. For example, it rounds negative 12.88 to negative 12. It rounds 12.88 to 12.