parseInt() (Function/global)

Parse a string to extract an integer value.

Availability:

ECMAScript edition - 2
JavaScript - 1.0
JScript - 1.0
Internet Explorer - 3.02
Netscape - 2.0
Netscape Enterprise Server version - 2.0
Opera - 3.0
Property/method value type:Number primitive
JavaScript syntax:-parseInt(aNumericString, aRadixValue)
Argument list:aNumericStringA string that comprises a meaningful numeric value.
aRadixValueA numeric value indicating the radix for conversion

The parseInt() function produces an integer value dictated by interpreting the string argument according to the specified radix. It can happily cope with hexadecimal values specified with the leading 0x or 0X notation. During conversion parseInt() will remove any leading whitespace characters. You don't need to do that to the string before parsing it.

Note also that parseInt() may only interpret the leading portion of a string. As soon as it encounters an invalid integer numeric character it will assume the scanning is complete. It will then silently ignore any remaining characters in the input argument.

Typical radix values are:

The result of this function call is an integer value, unless the string cannot be resolved to a meaningful value in which case NaN is returned instead.

See also:Cast operator, Function property, Global object, parseFloat(), String concatenate (+)

Property attributes:

DontEnum

Cross-references:

ECMA 262 edition 2 - section - 15.1.2.2

ECMA 262 edition 3 - section - 15.1.2.2