@GwtCompatible(serializable=true) public final class UnsignedLong extends Numberimplements Comparable <UnsignedLong >, Serializable
long
values, supporting arithmetic operations.
In some cases, when speed is more important than code readability, it may be faster simply to treat primitive long
values as unsigned, using the methods from UnsignedLongs
.
See the Guava User Guide article on unsigned primitive utilities.
Modifier and Type | Field and Description |
---|---|
static UnsignedLong |
MAX_VALUE
|
static UnsignedLong |
ONE
|
static UnsignedLong |
ZERO
|
Modifier and Type | Method and Description |
---|---|
BigInteger |
bigIntegerValue()
Returns the value of this
UnsignedLong as a
BigInteger .
|
int |
compareTo(UnsignedLong
|
UnsignedLong |
dividedBy(UnsignedLong
Returns the result of dividing this by
val .
|
double |
doubleValue()
Returns the value of this
UnsignedLong as a
double , analogous to a widening primitive conversion from
long to
double , and correctly rounded.
|
boolean |
equals(Object
|
float |
floatValue()
Returns the value of this
UnsignedLong as a
float , analogous to a widening primitive conversion from
long to
float , and correctly rounded.
|
static UnsignedLong |
fromLongBits(long bits)
Returns an
UnsignedLong corresponding to a given bit representation.
|
int |
hashCode()
|
int |
intValue()
Returns the value of this
UnsignedLong as an
int .
|
long |
longValue()
Returns the value of this
UnsignedLong as a
long .
|
UnsignedLong |
minus(UnsignedLong
Returns the result of subtracting this and
val .
|
UnsignedLong |
mod(UnsignedLong
Returns this modulo
val .
|
UnsignedLong |
plus(UnsignedLong
Returns the result of adding this and
val .
|
UnsignedLong |
times(UnsignedLong
Returns the result of multiplying this and
val .
|
String |
toString()
Returns a string representation of the
UnsignedLong value, in base 10.
|
String |
toString(int radix)
Returns a string representation of the
UnsignedLong value, in base
radix .
|
static UnsignedLong |
valueOf(BigInteger
Returns a
UnsignedLong representing the same value as the specified
BigInteger .
|
static UnsignedLong |
valueOf(long value)
Returns an
UnsignedLong representing the same value as the specified
long .
|
static UnsignedLong |
valueOf(String
Returns an
UnsignedLong holding the value of the specified
String , parsed as an unsigned
long value.
|
static UnsignedLong |
valueOf(String
Returns an
UnsignedLong holding the value of the specified
String , parsed as an unsigned
long value in the specified radix.
|
byteValue, shortValue
public static final UnsignedLongZERO
public static final UnsignedLongONE
public static final UnsignedLongMAX_VALUE
public static UnsignedLongfromLongBits(long bits)
UnsignedLong
corresponding to a given bit representation. The argument is interpreted as an unsigned 64-bit value. Specifically, the sign bit of
bits
is interpreted as a normal bit, and all other bits are treated as usual.
If the argument is nonnegative, the returned result will be equal to bits
, otherwise, the result will be equal to 2^64 + bits
.
To represent decimal constants less than 2^63
, consider valueOf(long)
instead.
public static UnsignedLongvalueOf(long value)
UnsignedLong
representing the same value as the specified
long
.
IllegalArgumentException
- if
value
is negative
public static UnsignedLongvalueOf(BigInteger value)
UnsignedLong
representing the same value as the specified
BigInteger
. This is the inverse operation of
bigIntegerValue()
.
IllegalArgumentException
- if
value
is negative or
value >= 2^64
public static UnsignedLongvalueOf(String string)
UnsignedLong
holding the value of the specified
String
, parsed as an unsigned
long
value.
NumberFormatException
- if the string does not contain a parsable unsigned
long
value
public static UnsignedLongvalueOf(String string, int radix)
UnsignedLong
holding the value of the specified
String
, parsed as an unsigned
long
value in the specified radix.
NumberFormatException
- if the string does not contain a parsable unsigned
long
value, or
radix
is not between
Character.MIN_RADIX
and
Character.MAX_RADIX
public UnsignedLongplus(UnsignedLong val)
val
. If the result would have more than 64 bits, returns the low 64 bits of the result.
public UnsignedLongminus(UnsignedLong val)
val
. If the result would have more than 64 bits, returns the low 64 bits of the result.
public UnsignedLongtimes(UnsignedLong val)
val
. If the result would have more than 64 bits, returns the low 64 bits of the result.
public UnsignedLongdividedBy(UnsignedLong val)
val
.
public UnsignedLongmod(UnsignedLong val)
val
.
public int intValue()
UnsignedLong
as an
int
.
public long longValue()
UnsignedLong
as a
long
. This is an inverse operation to
fromLongBits(long)
.
Note that if this UnsignedLong
holds a value >= 2^63
, the returned value will be equal to this - 2^64
.
public float floatValue()
UnsignedLong
as a
float
, analogous to a widening primitive conversion from
long
to
float
, and correctly rounded.
public double doubleValue()
UnsignedLong
as a
double
, analogous to a widening primitive conversion from
long
to
double
, and correctly rounded.
public BigIntegerbigIntegerValue()
UnsignedLong
as a
BigInteger
.
public int compareTo(UnsignedLongo)
public int hashCode()
public boolean equals(Objectobj)
public StringtoString()
UnsignedLong
value, in base 10.
public StringtoString(int radix)
UnsignedLong
value, in base
radix
. If
radix < Character.MIN_RADIX
or
radix > Character.MAX_RADIX
, the radix
10
is used.