An arbitrarily large integer.

Note: When compiling to JavaScript, integers are implemented as JavaScript numbers. When compiling to JavaScript, integers are therefore restricted to 53 significant bits because all JavaScript numbers are double-precision floating point values. The behavior of the operators and methods in the int class therefore sometimes differs between the Dart VM and Dart code compiled to JavaScript.

It is a compile-time error for a class to attempt to extend or implement int.

Inheritance

Static Methods

parse(String source, {int radix, int onError(String source)}) → int

Parse source as an integer literal and return its value.

Properties

bitLength int
read-only

Returns the minimum number of bits required to store this integer.

isEven bool
read-only

Returns true if and only if this integer is even.

isFinite bool
read-only, inherited

True if the number is finite; otherwise, false.

isInfinite bool
read-only, inherited

True if the number is positive infinity or negative infinity; otherwise, false.

isNaN bool
read-only, inherited

True if the number is the double Not-a-Number value; otherwise, false.

isNegative bool
read-only, inherited

True if the number is negative; otherwise, false.

isOdd bool
read-only

Returns true if and only if this integer is odd.

sign int
read-only

Returns the sign of this integer.

Constructors

int.fromEnvironment(String name, {int defaultValue})
const

Returns the integer value of the given environment declaration name.

Operators

operator %(num other) → num
inherited

Euclidean modulo operator.

operator &(int other) → int

Bit-wise and operator.

operator *(num other) → num
inherited

Multiplication operator.

operator +(num other) → num
inherited

Addition operator.

operator -(num other) → num
inherited

Subtraction operator.

operator /(num other) → double
inherited

Division operator.

operator <(num other) → bool
inherited

Relational less than operator.

operator <<(int shiftAmount) → int

Shift the bits of this integer to the left by shiftAmount.

operator <=(num other) → bool
inherited

Relational less than or equal operator.

operator ==(Object other) → bool
inherited

Test whether this value is numerically equal to other.

operator >(num other) → bool
inherited

Relational greater than operator.

operator >=(num other) → bool
inherited

Relational greater than or equal operator.

operator >>(int shiftAmount) → int

Shift the bits of this integer to the right by shiftAmount.

operator unary-() → int

Return the negative value of this integer.

operator ^(int other) → int

Bit-wise exclusive-or operator.

operator |(int other) → int

Bit-wise or operator.

operator ~() → int

The bit-wise negate operator.

operator ~/(num other) → int
inherited

Truncating division operator.

Methods

abs() → int

Returns the absolute value of this integer.

ceil() → int

Returns this.

ceilToDouble() → double

Returns this.toDouble().

clamp(num lowerLimit, num upperLimit) → num
inherited

Returns this num clamped to be in the range lowerLimit-upperLimit.

compareTo(num other) → int
inherited

Compares this to other.

floor() → int

Returns this.

floorToDouble() → double

Returns this.toDouble().

modPow(int exponent, int modulus) → int

Returns this integer to the power of exponent modulo modulus.

remainder(num other) → num
inherited

Returns the remainder of the truncating division of this by other.

round() → int

Returns this.

roundToDouble() → double

Returns this.toDouble().

toDouble() → double
inherited

Return this num as a double.

toInt() → int
inherited

Truncates this num to an integer and returns the result as an int.

toRadixString(int radix) → String

Converts this to a string representation in the given radix.

toSigned(int width) → int

Returns the least significant width bits of this integer, extending the highest retained bit to the sign. This is the same as truncating the value to fit in width bits using an signed 2-s complement representation. The returned value has the same bit value in all positions higher than width.

toString() → String

Returns a String-representation of this integer.

toStringAsExponential([int fractionDigits]) → String
inherited

Returns an exponential string-representation of this.

toStringAsFixed(int fractionDigits) → String
inherited

Returns a decimal-point string-representation of this.

toStringAsPrecision(int precision) → String
inherited

Converts this to a double and returns a string representation with exactly precision significant digits.

toUnsigned(int width) → int

Returns the least significant width bits of this integer as a non-negative number (i.e. unsigned representation). The returned value has zeros in all bit positions higher than width.

truncate() → int

Returns this.

truncateToDouble() → double

Returns this.toDouble().