public final class UnsignedBytes extends Object
byte
primitives that interpret values as
unsigned (that is, any negative value
b
is treated as the positive value
256 + b
). The corresponding methods that treat the values as signed are found in
SignedBytes
, and the methods for which signedness is not an issue are in
Bytes
.
See the Guava User Guide article on primitive utilities.
Modifier and Type | Field and Description |
---|---|
static byte |
MAX_POWER_OF_TWO
The largest power of two that can be represented as an unsigned
byte .
|
static byte |
MAX_VALUE
The largest value that fits into an unsigned byte.
|
Modifier and Type | Method and Description |
---|---|
static byte |
checkedCast(long value)
Returns the
byte value that, when treated as unsigned, is equal to
value , if possible.
|
static int |
compare(byte a, byte b)
Compares the two specified
byte values, treating them as unsigned values between 0 and 255 inclusive.
|
static String |
join(String
Returns a string containing the supplied
byte values separated by
separator .
|
static Comparator |
lexicographicalComparator()
Returns a comparator that compares two
byte arrays lexicographically.
|
static byte |
max(byte... array)
Returns the greatest value present in
array .
|
static byte |
min(byte... array)
Returns the least value present in
array .
|
static byte |
parseUnsignedByte(String
Returns the unsigned
byte value represented by the given decimal string.
|
static byte |
parseUnsignedByte(String
Returns the unsigned
byte value represented by a string with the given radix.
|
static byte |
saturatedCast(long value)
Returns the
byte value that, when treated as unsigned, is nearest in value to
value .
|
static int |
toInt(byte value)
Returns the value of the given byte as an integer, when treated as unsigned.
|
static String |
toString(byte x)
Returns a string representation of x, where x is treated as unsigned.
|
static String |
toString(byte x, int radix)
Returns a string representation of
x for the given radix, where
x is treated as unsigned.
|
public static final byte MAX_POWER_OF_TWO
byte
.
public static final byte MAX_VALUE
public static int toInt(byte value)
value + 256
if
value
is negative;
value
itself otherwise.
public static byte checkedCast(long value)
byte
value that, when treated as unsigned, is equal to
value
, if possible.
value
- a value between 0 and 255 inclusive
byte
value that, when treated as unsigned, equals
value
IllegalArgumentException
- if
value
is negative or greater than 255
public static byte saturatedCast(long value)
byte
value that, when treated as unsigned, is nearest in value to
value
.
value
- any
long
value
(byte) 255
if
value >= 255
,
(byte) 0
if
value <= 0
, and
value
cast to
byte
otherwise
public static int compare(byte a, byte b)
byte
values, treating them as unsigned values between 0 and 255 inclusive. For example,
(byte) -127
is considered greater than
(byte) 127
because it is seen as having the value of positive
129
.
a
- the first
byte
to compare
b
- the second
byte
to compare
a
is less than
b
; a positive value if
a
is greater than
b
; or zero if they are equal
public static byte min(byte... array)
array
.
array
- a
nonempty array of
byte
values
array
that is less than or equal to every other value in the array
IllegalArgumentException
- if
array
is empty
public static byte max(byte... array)
array
.
array
- a
nonempty array of
byte
values
array
that is greater than or equal to every other value in the array
IllegalArgumentException
- if
array
is empty
@Beta public static StringtoString(byte x)
@Beta public static StringtoString(byte x, int radix)
x
for the given radix, where
x
is treated as unsigned.
x
- the value to convert to a string.
radix
- the radix to use while working with
x
IllegalArgumentException
- if
radix
is not between
Character.MIN_RADIX
and
Character.MAX_RADIX
.
@Beta public static byte parseUnsignedByte(Stringstring)
byte
value represented by the given decimal string.
NumberFormatException
- if the string does not contain a valid unsigned
byte
value
NullPointerException
- if
s
is null (in contrast to
Byte.parseByte(String)
)
@Beta public static byte parseUnsignedByte(Stringstring, int radix)
byte
value represented by a string with the given radix.
string
- the string containing the unsigned
byte
representation to be parsed.
radix
- the radix to use while parsing
string
NumberFormatException
- if the string does not contain a valid unsigned
byte
with the given radix, or if
radix
is not between
Character.MIN_RADIX
and
Character.MAX_RADIX
.
NullPointerException
- if
s
is null (in contrast to
Byte.parseByte(String)
)
public static Stringjoin(String separator, byte... array)
byte
values separated by
separator
. For example,
join(":", (byte) 1, (byte) 2, (byte) 255)
returns the string
"1:2:255"
.
separator
- the text that should appear between consecutive values in the resulting string (but not at the start or end)
array
- an array of
byte
values, possibly empty
public static Comparator<byte[]> lexicographicalComparator()
byte
arrays lexicographically. That is, it compares, using
compare(byte, byte)
), the first pair of values that follow any common prefix, or when one array is a prefix of the other, treats the shorter array as the lesser. For example,
[] < [0x01] < [0x01, 0x7F] < [0x01, 0x80] < [0x02]
. Values are treated as unsigned.
The returned comparator is inconsistent with Object
(since arrays support only identity equality), but it is consistent with Arrays
.