Class Shorts
- java.lang.Object
-
- com.google.common.primitives.Shorts
-
@GwtCompatible(emulated=true) @Deprecated(since="2022-12-01") public final class Shorts extends java.lang.Object
Deprecated.The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023Static 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
-
-
Field Summary
Fields Modifier and Type Field Description static int
BYTES
Deprecated.The number of bytes required to represent a primitiveshort
value.static short
MAX_POWER_OF_TWO
Deprecated.The largest power of two that can be represented as ashort
.
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static java.util.List<java.lang.Short>
asList(short... backingArray)
Deprecated.Returns a fixed-size list backed by the specified array, similar toArrays.asList(Object[])
.static short
checkedCast(long value)
Deprecated.Returns theshort
value that is equal tovalue
, if possible.static int
compare(short a, short b)
Deprecated.Compares the two specifiedshort
values.static short[]
concat(short[]... arrays)
Deprecated.Returns the values from each provided array combined into a single array.static boolean
contains(short[] array, short target)
Deprecated.Returnstrue
iftarget
is present as an element anywhere inarray
.static short[]
ensureCapacity(short[] array, int minLength, int padding)
Deprecated.Returns an array containing the same values asarray
, but guaranteed to be of a specified minimum length.static short
fromByteArray(byte[] bytes)
Deprecated.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)
Deprecated.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)
Deprecated.Returns a hash code forvalue
; equal to the result of invoking((Short) value).hashCode()
.static int
indexOf(short[] array, short target)
Deprecated.Returns the index of the first appearance of the valuetarget
inarray
.static int
indexOf(short[] array, short[] target)
Deprecated.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)
Deprecated.Returns a string containing the suppliedshort
values separated byseparator
.static int
lastIndexOf(short[] array, short target)
Deprecated.Returns the index of the last appearance of the valuetarget
inarray
.static java.util.Comparator<short[]>
lexicographicalComparator()
Deprecated.Returns a comparator that compares twoshort
arrays lexicographically.static short
max(short... array)
Deprecated.Returns the greatest value present inarray
.static short
min(short... array)
Deprecated.Returns the least value present inarray
.static short
saturatedCast(long value)
Deprecated.Returns theshort
nearest in value tovalue
.static short[]
toArray(java.util.Collection<? extends java.lang.Number> collection)
Deprecated.Returns an array containing each value ofcollection
, converted to ashort
value in the manner ofNumber.shortValue()
.static byte[]
toByteArray(short value)
Deprecated.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
Deprecated.The number of bytes required to represent a primitiveshort
value.- See Also:
- Constant Field Values
-
MAX_POWER_OF_TWO
public static final short MAX_POWER_OF_TWO
Deprecated.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)
Deprecated.Returns a hash code forvalue
; equal to the result of invoking((Short) value).hashCode()
.- Parameters:
value
- a primitiveshort
value- Returns:
- a hash code for the value
-
checkedCast
public static short checkedCast(long value)
Deprecated.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)
Deprecated.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)
Deprecated.Compares the two specifiedshort
values. The sign of the value returned is the same as that of((Short) a).compareTo(b)
.- 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)
Deprecated.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)
Deprecated.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)
Deprecated.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 thatjava.util.Arrays.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)
Deprecated.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
public static short min(short... array)
Deprecated.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
public static short max(short... array)
Deprecated.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
-
concat
public static short[] concat(short[]... arrays)
Deprecated.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("doesn\'t work") public static byte[] toByteArray(short value)
Deprecated.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("doesn\'t work") public static short fromByteArray(byte[] bytes)
Deprecated.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("doesn\'t work") public static short fromBytes(byte b1, byte b2)
Deprecated.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
-
ensureCapacity
public static short[] ensureCapacity(short[] array, int minLength, int padding)
Deprecated.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)
Deprecated.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()
Deprecated.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
- See Also:
- Lexicographical order article at Wikipedia
-
toArray
public static short[] toArray(java.util.Collection<? extends java.lang.Number> collection)
Deprecated.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)
Deprecated.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.- Parameters:
backingArray
- the array to back the list- Returns:
- a list view of the array
-
-