Class Shorts
- java.lang.Object
-
- com.google.common.primitives.Shorts
-
@GwtCompatible(emulated=true) public final class Shorts extends java.lang.Object
Static utility methods pertaining toshort
primitives, that are not already found in eitherShort
orArrays
.See the Guava User Guide article on primitive utilities.
- Since:
- 1.0
- Author:
- Kevin Bourrillion
-
-
Field Summary
Fields Modifier and Type Field Description static int
BYTES
The number of bytes required to represent a primitiveshort
value.static short
MAX_POWER_OF_TWO
The largest power of two that can be represented as ashort
.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static java.util.List<java.lang.Short>
asList(short... backingArray)
Returns a fixed-size list backed by the specified array, similar toArrays.asList(Object[])
.static short
checkedCast(long value)
Returns theshort
value that is equal tovalue
, if possible.static int
compare(short a, short b)
Compares the two specifiedshort
values.static short[]
concat(short[]... arrays)
Returns the values from each provided array combined into a single array.static short
constrainToRange(short value, short min, short max)
Returns the value nearest tovalue
which is within the closed range[min..max]
.static boolean
contains(short[] array, short target)
Returnstrue
iftarget
is present as an element anywhere inarray
.static short[]
ensureCapacity(short[] array, int minLength, int padding)
Returns an array containing the same values asarray
, but guaranteed to be of a specified minimum length.static short
fromByteArray(byte[] bytes)
Returns theshort
value whose big-endian representation is stored in the first 2 bytes ofbytes
; equivalent toByteBuffer.wrap(bytes).getShort()
.static short
fromBytes(byte b1, byte b2)
Returns theshort
value whose byte representation is the given 2 bytes, in big-endian order; equivalent toShorts.fromByteArray(new byte[] {b1, b2})
.static int
hashCode(short value)
Returns a hash code forvalue
; equal to the result of invoking((Short) value).hashCode()
.static int
indexOf(short[] array, short target)
Returns the index of the first appearance of the valuetarget
inarray
.static int
indexOf(short[] array, short[] target)
Returns the start position of the first occurrence of the specifiedtarget
withinarray
, or-1
if there is no such occurrence.static java.lang.String
join(java.lang.String separator, short... array)
Returns a string containing the suppliedshort
values separated byseparator
.static int
lastIndexOf(short[] array, short target)
Returns the index of the last appearance of the valuetarget
inarray
.static java.util.Comparator<short[]>
lexicographicalComparator()
Returns a comparator that compares twoshort
arrays lexicographically.static short
max(short... array)
Returns the greatest value present inarray
.static short
min(short... array)
Returns the least value present inarray
.static void
reverse(short[] array)
Reverses the elements ofarray
.static void
reverse(short[] array, int fromIndex, int toIndex)
Reverses the elements ofarray
betweenfromIndex
inclusive andtoIndex
exclusive.static void
rotate(short[] array, int distance)
Performs a right rotation ofarray
of "distance" places, so that the first element is moved to index "distance", and the element at indexi
ends up at index(distance + i) mod array.length
.static void
rotate(short[] array, int distance, int fromIndex, int toIndex)
Performs a right rotation ofarray
betweenfromIndex
inclusive andtoIndex
exclusive.static short
saturatedCast(long value)
Returns theshort
nearest in value tovalue
.static void
sortDescending(short[] array)
Sorts the elements ofarray
in descending order.static void
sortDescending(short[] array, int fromIndex, int toIndex)
Sorts the elements ofarray
betweenfromIndex
inclusive andtoIndex
exclusive in descending order.static Converter<java.lang.String,java.lang.Short>
stringConverter()
Returns a serializable converter object that converts between strings and shorts usingShort.decode(java.lang.String)
andShort.toString()
.static short[]
toArray(java.util.Collection<? extends java.lang.Number> collection)
Returns an array containing each value ofcollection
, converted to ashort
value in the manner ofNumber.shortValue()
.static byte[]
toByteArray(short value)
Returns a big-endian representation ofvalue
in a 2-element byte array; equivalent toByteBuffer.allocate(2).putShort(value).array()
.
-
-
-
Field Detail
-
BYTES
public static final int BYTES
The number of bytes required to represent a primitiveshort
value.Java 8+ users: use
Short.BYTES
instead.- See Also:
- Constant Field Values
-
MAX_POWER_OF_TWO
public static final short MAX_POWER_OF_TWO
The largest power of two that can be represented as ashort
.- Since:
- 10.0
- See Also:
- Constant Field Values
-
-
Method Detail
-
hashCode
public static int hashCode(short value)
Returns a hash code forvalue
; equal to the result of invoking((Short) value).hashCode()
.Java 8+ users: use
Short.hashCode(short)
instead.- Parameters:
value
- a primitiveshort
value- Returns:
- a hash code for the value
-
checkedCast
public static short checkedCast(long value)
Returns theshort
value that is equal tovalue
, if possible.- Parameters:
value
- any value in the range of theshort
type- Returns:
- the
short
value that equalsvalue
- Throws:
java.lang.IllegalArgumentException
- ifvalue
is greater thanShort.MAX_VALUE
or less thanShort.MIN_VALUE
-
saturatedCast
public static short saturatedCast(long value)
Returns theshort
nearest in value tovalue
.- Parameters:
value
- anylong
value- Returns:
- the same value cast to
short
if it is in the range of theshort
type,Short.MAX_VALUE
if it is too large, orShort.MIN_VALUE
if it is too small
-
compare
public static int compare(short a, short b)
Compares the two specifiedshort
values. The sign of the value returned is the same as that of((Short) a).compareTo(b)
.Java 7+ users: this method should be treated as deprecated; use the equivalent
Short.compare(short, short)
method instead.- Parameters:
a
- the firstshort
to compareb
- the secondshort
to compare- Returns:
- a negative value if
a
is less thanb
; a positive value ifa
is greater thanb
; or zero if they are equal
-
contains
public static boolean contains(short[] array, short target)
Returnstrue
iftarget
is present as an element anywhere inarray
.- Parameters:
array
- an array ofshort
values, possibly emptytarget
- a primitiveshort
value- Returns:
true
ifarray[i] == target
for some value ofi
-
indexOf
public static int indexOf(short[] array, short target)
Returns the index of the first appearance of the valuetarget
inarray
.- Parameters:
array
- an array ofshort
values, possibly emptytarget
- a primitiveshort
value- Returns:
- the least index
i
for whicharray[i] == target
, or-1
if no such index exists.
-
indexOf
public static int indexOf(short[] array, short[] target)
Returns the start position of the first occurrence of the specifiedtarget
withinarray
, or-1
if there is no such occurrence.More formally, returns the lowest index
i
such thatArrays.copyOfRange(array, i, i + target.length)
contains exactly the same elements astarget
.- Parameters:
array
- the array to search for the sequencetarget
target
- the array to search for as a sub-sequence ofarray
-
lastIndexOf
public static int lastIndexOf(short[] array, short target)
Returns the index of the last appearance of the valuetarget
inarray
.- Parameters:
array
- an array ofshort
values, possibly emptytarget
- a primitiveshort
value- Returns:
- the greatest index
i
for whicharray[i] == target
, or-1
if no such index exists.
-
min
@GwtIncompatible("Available in GWT! Annotation is to avoid conflict with GWT specialization of base class.") public static short min(short... array)
Returns the least value present inarray
.- Parameters:
array
- a nonempty array ofshort
values- Returns:
- the value present in
array
that is less than or equal to every other value in the array - Throws:
java.lang.IllegalArgumentException
- ifarray
is empty
-
max
@GwtIncompatible("Available in GWT! Annotation is to avoid conflict with GWT specialization of base class.") public static short max(short... array)
Returns the greatest value present inarray
.- Parameters:
array
- a nonempty array ofshort
values- Returns:
- the value present in
array
that is greater than or equal to every other value in the array - Throws:
java.lang.IllegalArgumentException
- ifarray
is empty
-
constrainToRange
public static short constrainToRange(short value, short min, short max)
Returns the value nearest tovalue
which is within the closed range[min..max]
.If
value
is within the range[min..max]
,value
is returned unchanged. Ifvalue
is less thanmin
,min
is returned, and ifvalue
is greater thanmax
,max
is returned.- Parameters:
value
- theshort
value to constrainmin
- the lower bound (inclusive) of the range to constrainvalue
tomax
- the upper bound (inclusive) of the range to constrainvalue
to- Throws:
java.lang.IllegalArgumentException
- ifmin > max
- Since:
- 21.0
-
concat
public static short[] concat(short[]... arrays)
Returns the values from each provided array combined into a single array. For example,concat(new short[] {a, b}, new short[] {}, new short[] {c}
returns the array{a, b, c}
.- Parameters:
arrays
- zero or moreshort
arrays- Returns:
- a single array containing all the values from the source arrays, in order
-
toByteArray
@GwtIncompatible public static byte[] toByteArray(short value)
Returns a big-endian representation ofvalue
in a 2-element byte array; equivalent toByteBuffer.allocate(2).putShort(value).array()
. For example, the input value(short) 0x1234
would yield the byte array{0x12, 0x34}
.If you need to convert and concatenate several values (possibly even of different types), use a shared
ByteBuffer
instance, or useByteStreams.newDataOutput()
to get a growable buffer.
-
fromByteArray
@GwtIncompatible public static short fromByteArray(byte[] bytes)
Returns theshort
value whose big-endian representation is stored in the first 2 bytes ofbytes
; equivalent toByteBuffer.wrap(bytes).getShort()
. For example, the input byte array{0x54, 0x32}
would yield theshort
value0x5432
.Arguably, it's preferable to use
ByteBuffer
; that library exposes much more flexibility at little cost in readability.- Throws:
java.lang.IllegalArgumentException
- ifbytes
has fewer than 2 elements
-
fromBytes
@GwtIncompatible public static short fromBytes(byte b1, byte b2)
Returns theshort
value whose byte representation is the given 2 bytes, in big-endian order; equivalent toShorts.fromByteArray(new byte[] {b1, b2})
.- Since:
- 7.0
-
stringConverter
public static Converter<java.lang.String,java.lang.Short> stringConverter()
Returns a serializable converter object that converts between strings and shorts usingShort.decode(java.lang.String)
andShort.toString()
. The returned converter throwsNumberFormatException
if the input string is invalid.Warning: please see
Short.decode(java.lang.String)
to understand exactly how strings are parsed. For example, the string"0123"
is treated as octal and converted to the value83
.- Since:
- 16.0
-
ensureCapacity
public static short[] ensureCapacity(short[] array, int minLength, int padding)
Returns an array containing the same values asarray
, but guaranteed to be of a specified minimum length. Ifarray
already has a length of at leastminLength
, it is returned directly. Otherwise, a new array of sizeminLength + padding
is returned, containing the values ofarray
, and zeroes in the remaining places.- Parameters:
array
- the source arrayminLength
- the minimum length the returned array must guaranteepadding
- an extra amount to "grow" the array by if growth is necessary- Returns:
- an array containing the values of
array
, with guaranteed minimum lengthminLength
- Throws:
java.lang.IllegalArgumentException
- ifminLength
orpadding
is negative
-
join
public static java.lang.String join(java.lang.String separator, short... array)
Returns a string containing the suppliedshort
values separated byseparator
. For example,join("-", (short) 1, (short) 2, (short) 3)
returns the string"1-2-3"
.- Parameters:
separator
- the text that should appear between consecutive values in the resulting string (but not at the start or end)array
- an array ofshort
values, possibly empty
-
lexicographicalComparator
public static java.util.Comparator<short[]> lexicographicalComparator()
Returns a comparator that compares twoshort
arrays lexicographically. That is, it compares, usingcompare(short, short)
), 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,[] < [(short) 1] < [(short) 1, (short) 2] < [(short) 2]
.The returned comparator is inconsistent with
Object.equals(Object)
(since arrays support only identity equality), but it is consistent withArrays.equals(short[], short[])
.- Since:
- 2.0
-
sortDescending
public static void sortDescending(short[] array)
Sorts the elements ofarray
in descending order.- Since:
- 23.1
-
sortDescending
public static void sortDescending(short[] array, int fromIndex, int toIndex)
Sorts the elements ofarray
betweenfromIndex
inclusive andtoIndex
exclusive in descending order.- Since:
- 23.1
-
reverse
public static void reverse(short[] array)
Reverses the elements ofarray
. This is equivalent toCollections.reverse(Shorts.asList(array))
, but is likely to be more efficient.- Since:
- 23.1
-
reverse
public static void reverse(short[] array, int fromIndex, int toIndex)
Reverses the elements ofarray
betweenfromIndex
inclusive andtoIndex
exclusive. This is equivalent toCollections.reverse(Shorts.asList(array).subList(fromIndex, toIndex))
, but is likely to be more efficient.- Throws:
java.lang.IndexOutOfBoundsException
- iffromIndex < 0
,toIndex > array.length
, ortoIndex > fromIndex
- Since:
- 23.1
-
rotate
public static void rotate(short[] array, int distance)
Performs a right rotation ofarray
of "distance" places, so that the first element is moved to index "distance", and the element at indexi
ends up at index(distance + i) mod array.length
. This is equivalent toCollections.rotate(Shorts.asList(array), distance)
, but is considerably faster and avoids allocation and garbage collection.The provided "distance" may be negative, which will rotate left.
- Since:
- 32.0.0
-
rotate
public static void rotate(short[] array, int distance, int fromIndex, int toIndex)
Performs a right rotation ofarray
betweenfromIndex
inclusive andtoIndex
exclusive. This is equivalent toCollections.rotate(Shorts.asList(array).subList(fromIndex, toIndex), distance)
, but is considerably faster and avoids allocations and garbage collection.The provided "distance" may be negative, which will rotate left.
- Throws:
java.lang.IndexOutOfBoundsException
- iffromIndex < 0
,toIndex > array.length
, ortoIndex > fromIndex
- Since:
- 32.0.0
-
toArray
public static short[] toArray(java.util.Collection<? extends java.lang.Number> collection)
Returns an array containing each value ofcollection
, converted to ashort
value in the manner ofNumber.shortValue()
.Elements are copied from the argument collection as if by
collection.toArray()
. Calling this method is as thread-safe as calling that method.- Parameters:
collection
- a collection ofNumber
instances- Returns:
- an array containing the same values as
collection
, in the same order, converted to primitives - Throws:
java.lang.NullPointerException
- ifcollection
or any of its elements is null- Since:
- 1.0 (parameter was
Collection<Short>
before 12.0)
-
asList
public static java.util.List<java.lang.Short> asList(short... backingArray)
Returns a fixed-size list backed by the specified array, similar toArrays.asList(Object[])
. The list supportsList.set(int, Object)
, but any attempt to set a value tonull
will result in aNullPointerException
.The returned list maintains the values, but not the identities, of
Short
objects written to or read from it. For example, whetherlist.get(0) == list.get(0)
is true for the returned list is unspecified.The returned list is serializable.
- Parameters:
backingArray
- the array to back the list- Returns:
- a list view of the array
-
-