dgrove@google.com
747b22d3bc
is available, this package will likely be moved there. Review URL: https://chromiumcodereview.appspot.com//10854162 git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@10769 260f80e4-7a28-3924-810f-c04153c831b5
104 lines
2.4 KiB
Dart
104 lines
2.4 KiB
Dart
// Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
|
|
// for details. All rights reserved. Use of this source code is governed by a
|
|
// BSD-style license that can be found in the LICENSE file.
|
|
|
|
/**
|
|
* A fixed-precision integer.
|
|
*/
|
|
interface intx extends Comparable, Hashable {
|
|
|
|
// Arithmetic operations.
|
|
intx operator +(other);
|
|
intx operator -(other);
|
|
// The unary '-' operator. Note that -MIN_VALUE will be equal
|
|
// to MIN_VALUE due to overflow.
|
|
intx operator negate();
|
|
intx operator *(other);
|
|
intx operator %(other);
|
|
// Truncating division.
|
|
intx operator ~/(other);
|
|
intx remainder(other);
|
|
|
|
// Note: no / operator
|
|
|
|
// Bit-operations.
|
|
intx operator &(other);
|
|
intx operator |(other);
|
|
intx operator ^(other);
|
|
intx operator ~();
|
|
intx operator <<(int shiftAmount);
|
|
intx operator >>(int shiftAmount);
|
|
intx shiftRightUnsigned(int shiftAmount);
|
|
|
|
// Relational operations, may be applied to intx or int.
|
|
int compareTo(Comparable other);
|
|
bool operator ==(other);
|
|
bool operator <(other);
|
|
bool operator <=(other);
|
|
bool operator >(other);
|
|
bool operator >=(other);
|
|
|
|
// Testers.
|
|
bool isEven();
|
|
bool isMaxValue();
|
|
bool isMinValue();
|
|
bool isNegative();
|
|
bool isOdd();
|
|
bool isZero();
|
|
|
|
int hashCode();
|
|
|
|
intx abs();
|
|
|
|
/**
|
|
* Returns the number of leading zeros in this [intx] as an [int]
|
|
* between 0 and 64.
|
|
*/
|
|
int numberOfLeadingZeros();
|
|
|
|
/**
|
|
* Returns the number of trailing zeros in this [intx] as an [int]
|
|
* between 0 and 64.
|
|
*/
|
|
int numberOfTrailingZeros();
|
|
|
|
/**
|
|
* Converts this [intx] to a [List] of [int], starting with the least
|
|
* significant byte.
|
|
*/
|
|
List<int> toBytes();
|
|
|
|
/**
|
|
* Converts this [intx] to an [int]. On some platforms, inputs with large
|
|
* absolute values (i.e., > 2^52) may lose some of their low bits.
|
|
*/
|
|
int toInt();
|
|
|
|
/**
|
|
* Converts an [intx] to 32 bits. Narrower values are sign extended and
|
|
* wider values have their high bits truncated.
|
|
*/
|
|
int32 toInt32();
|
|
|
|
/**
|
|
* Converts an [intx] to 64 bits.
|
|
*/
|
|
int64 toInt64();
|
|
|
|
/**
|
|
* Returns the value of this [intx] as a decimal [String].
|
|
*/
|
|
String toString();
|
|
|
|
/**
|
|
* Returns the value of this [intx] as a hexadecimal [String].
|
|
*/
|
|
String toHexString();
|
|
|
|
/**
|
|
* Returns the value of this [intx] as a [String] in the given radix.
|
|
* [radix] must be an integer between 2 and 16, inclusive.
|
|
*/
|
|
String toRadixString(int radix);
|
|
}
|