Guava - PRIMITIVE UTILITIES

As primitive types of Java cannot be used to pass in generics or in collections as input, Guava provided a lot of Wrapper Utilities classes to handle primitive types as Objects. Following is the list of useful primitive processing utilities:

S.N.	Utility name & Description
1	Bytes Utility for primitive byte.
2	Shorts Utility for primitive short.
3	Ints Utility for primitive int.
4	Longs Utility for primitive long.
5	Floats Utility for primitive float.
6	Doubles Utility for primitive double.
7	Chars Utility for primitive char.
8	Booleans Utility for primitive boolean.

Bytes Class

Bytes is a utility class for primitive type byte.

Class Declaration

Following is the declaration for com.google.common.primitives.Bytes class:


Methods

S.N.	Method & Description
1	static List<Byte> asList(byte... backingArray) Returns a fixed-size list backed by the specified array, similar to Arrays.asList(Object[]).
2	static byte[] concat(byte[]... arrays) Returns the values from each provided array combined into a single array.
3	static boolean contains(byte[] array, byte target) Returns true if the target is present as an element anywhere in array.
4	static byte[] ensureCapacity(byte[] array, int minLength, int padding) Returns an array containing the same values as the array, but guaranteed to be of a specified minimum length.
5	static int hashCode(byte value) Returns a hash code for value; equal to the result of invoking ((Byte) value).hashCode().
6	static int indexOf(byte[] array, byte target) Returns the index of the first appearance of the value target in array.
7	static int indexOf(byte[] array, byte[] target) Returns the start position of the first occurrence of the specified target within the array, or -1 if there is no such occurrence.
8	static int lastIndexOf(byte[] array, byte target) Returns the index of the last appearance of the value target in array.
9	static byte[] toArray(Collection<? extends Number> collection) Returns an array containing each value of collection, converted to a byte value in the manner of Number.byteValue().

Methods Inherited

This class inherits methods from the following class:

• java.lang.Object

Example of Bytes Class

Create the following java program using any editor of your choice in say C:/> Guava.

GuavaTester.java


Verify the Result

Compile the class using javac compiler as follows:


Now run the GuavaTester to see the result.


See the result.


Shorts Class

Shorts is a utility class for primitive type short.

Class Declaration

Following is the declaration for com.google.common.primitives.Shorts class:


Fields

S.N.	Field & Description
1	static int BYTES The number of bytes required to represent a primitive short value.
2	static short MAX_POWER_OF_TWO The largest power of two that can be represented as a short.

Methods

S.N.	Method & Description
1	static List<Short> asList(short... backingArray) Returns a fixed-size list backed by the specified array, similar to Arrays.asList(Object[]).
2	static short checkedCast(long value) Returns the short value that is equal to value, if possible.
3	static int compare(short a, short b) Compares the two specified short values.
4	static short[] concat(short[]... arrays) Returns the values from each provided array combined into a single array.
5	static boolean contains(short[] array, short target) Returns true if target is present as an element anywhere in array.
6	static short[] ensureCapacity(short[] array, int minLength, int padding) Returns an array containing the same values as array, but guaranteed to be of a specified minimum length.
7	static short fromByteArray(byte[] bytes) Returns the short value whose big-endian representation is stored in the first 2 bytes of bytes; equivalent to ByteBuffer.wrap(bytes).getShort().
8	static short fromBytes(byte b1, byte b2) Returns the short value whose byte representation is the given 2 bytes, in big-endian order; equivalent to Shorts.fromByteArray(new byte[] {b1, b2}).
9	static int hashCode(short value) Returns a hash code for value; equal to the result of invoking ((Short) value).hashCode().
10	static int indexOf(short[] array, short target) Returns the index of the first appearance of the value target in array.
11	static int indexOf(short[] array, short[] target) Returns the start position of the first occurrence of the specified target within array, or -1 if there is no such occurrence.
12	static String join(String separator, short... array) Returns a string containing the supplied short values separated by separator.
13	static int lastIndexOf(short[] array, short target) Returns the index of the last appearance of the value target in array.
14	static Comparator<short[]> lexicographicalComparator() Returns a comparator that compares two short arrays lexicographically.
15	static short max(short... array) Returns the greatest value present in array.
16	static short min(short... array) Returns the least value present in array.
17	static short saturatedCast(long value) Returns the short nearest in value to value.
18	static Converter<String,Short> stringConverter() Returns a serializable converter object that converts between strings and shorts using Short.decode(java.lang.String) and Short.toString().
19	static short[] toArray(Collection<? extends Number> collection) Returns an array containing each value of collection, converted to a short value in the manner of Number.shortValue().
20	static byte[] toByteArray(short value) Returns a big-endian representation of value in a 2-element byte array; equivalent to ByteBuffer.allocate(2).putShort(value).array().

Methods Inherited

This class inherits methods from the following class:

• java.lang.Object

Example of Ints Class

Create the following java program using any editor of your choice in say C:/> Guava.

GuavaTester.java
Verify the Result

Compile the class using javac compiler as follows:


Now run the GuavaTester to see the result.


See the result.


Longs Class

Longs is a utility class for primitive type long.

Class Declaration

Following is the declaration for com.google.common.primitives.Longs class:


Fields

S.N.	Method & Description
1	static List<Long> asList(long... backingArray) Returns a fixed-size list backed by the specified array, similar to Arrays.asList(Object[]).
2	static int compare(long a, long b) Compares the two specified long values.
3	static long[] concat(long[]... arrays) Returns the values from each provided array combined into a single array.
4	static boolean contains(long[] array, long target) Returns true if target is present as an element anywhere in array.
5	static long[] ensureCapacity(long[] array, int minLength, int padding) Returns an array containing the same values as array, but guaranteed to be of a specified minimum length.
6	static long fromByteArray(byte[] bytes) Returns the long value whose big-endian representation is stored in the first 8 bytes of bytes; equivalent to ByteBuffer.wrap(bytes).getLong().
7	static long fromBytes(byte b1, byte b2, byte b3, byte b4, byte b5, byte b6, byte b7, byte b8) Returns the long value whose byte representation is the given 8 bytes, in big-endian order; equivalent to Longs.fromByteArray(new byte[] {b1, b2, b3, b4, b5, b6, b7, b8}).
8	static int hashCode(long value) Returns a hash code for value; equal to the result of invoking ((Long) value).hashCode().
9	static int indexOf(long[] array, long target) Returns the index of the first appearance of the value target in array.
10	static int indexOf(long[] array, long[] target) Returns the start position of the first occurrence of the specified target within array, or -1 if there is no such occurrence.
11	static String join(String separator, long... array) Returns a string containing the supplied long values separated by separator.
12	static int lastIndexOf(long[] array, long target) Returns the index of the last appearance of the value target in array.
13	static Comparator<long[]> lexicographicalComparator() Returns a comparator that compares two long arrays lexicographically.
14	static long max(long... array) Returns the greatest value present in array.
15	static long min(long... array) Returns the least value present in array.
16	static Converter<String,Long> stringConverter() Returns a serializable converter object that converts between strings and longs using Long.decode(java.lang.String) and Long.toString().
17	static long[] toArray(Collection<? extends Number> collection) Returns an array containing each value of collection, converted to a long value in the manner of Number.longValue().
18	static byte[] toByteArray(long value) Returns a big-endian representation of value in an 8-element byte array; equivalent to ByteBuffer.allocate(8).putLong(value).array().
19	static Long tryParse(String string) Parses the specified string as a signed decimal long value.

Methods Inherited

This class inherits methods from the following class:

• java.lang.Object

Example of Longs Class

Create the following java program using any editor of your choice in say C:/> Guava.

GuavaTester.java

Verify the Result

Compile the class using javac compiler as follows:


Now run the GuavaTester to see the result.


See the result.


Floats Class

Floats is a utility class for primitive type float.

Class Declaration

Following is the declaration for com.google.common.primitives.Floats class:


Fields

S.N.	Field & Description
1	static int BYTES The number of bytes required to represent a primitive float value.

Methods

S.N	Method & Description
1	static List<Float> asList(float... backingArray) Returns a fixed-size list backed by the specified array, similar to Arrays.asList(Object[]).
2	static int compare(float a, float b) Compares the two specified float values using Float.compare(float, float).
3	static float[] concat(float[]... arrays) Returns the values from each provided array combined into a single array.
4	static boolean contains(float[] array, float target) Returns true if target is present as an element anywhere in array.
5	static float[] ensureCapacity(float[] array, int minLength, int padding) Returns an array containing the same values as the array, but guaranteed to be of a specified minimum length.
6	static int hashCode(float value) Returns a hash code for value; equal to the result of invoking ((Float) value).hashCode().
7	static int indexOf(float[] array, float target) Returns the index of the first appearance of the value target in array.
8	static int indexOf(float[] array, float[] target) Returns the start position of the first occurrence of the specified target within array, or -1 if there is no such occurrence.
9	static boolean isFinite(float value) Returns true if value represents a real number.
10	static String join(String separator, float... array) Returns a string containing the supplied float values, converted to strings as specified by Float.toString(float), and separated by separator.
11	static int lastIndexOf(float[] array, float target) Returns the index of the last appearance of the value target in array.
12	static Comparator<float[]> lexicographicalComparator() Returns a comparator that compares two float arrays lexicographically.
13	static float max(float... array) Returns the greatest value present in array, using the same rules of comparison as Math.min(float, float).
14	static float min(float... array) Returns the least value present in array, using the same rules of comparison as Math.min(float, float).
15	static Converter<String,Float> stringConverter() Returns a serializable converter object that converts between strings and floats using Float.valueOf(java.lang.String) and Float.toString().
16	static float[] toArray(Collection<? extends Number> collection) Returns an array containing each value of collection, converted to a float value in the manner of Number.floatValue().
17	static Float tryParse(String string) Parses the specified string as a single-precision floating point value.

Methods Inherited

This class inherits methods from the following class:

• java.lang.Object

Example of Floats Class

Create the following java program using any editor of your choice in say C:/> Guava.

GuavaTester.java

Verify the Result

Compile the class using javac compiler as follows:


Now run the GuavaTester to see the result.


See the result.


Doubles Class

Doubles is a utility class for primitive type double.

Class Declaration

Following is the declaration for com.google.common.primitives.Doubles class:


Fields

S.N	Field & Description
1	static int BYTES The number of bytes required to represent a primitive double value.

Methods

S.N.	Method & Description
1	static List<Double> asList(double... backingArray) Returns a fixed-size list backed by the specified array, similar to Arrays.asList(Object[]).
2	static int compare(double a, double b) Compares the two specified double values.
3	static double[] concat(double[]... arrays) Returns the values from each provided array combined into a single array.
4	static boolean contains(double[] array, double target) Returns true if target is present as an element anywhere in array.
5	static double[] ensureCapacity(double[] array, int minLength, int padding) Returns an array containing the same values as the array, but guaranteed to be of a specified minimum length.
6	static int hashCode(double value) Returns a hash code for value; equal to the result of invoking ((Double) value).hashCode().
7	static int indexOf(double[] array, double target) Returns the index of the first appearance of the value target in array.
8	static int indexOf(double[] array, double[] target) Returns the start position of the first occurrence of the specified target within array, or -1 if there is no such occurrence.
9	static boolean isFinite(double value) Returns true if value represents a real number.
10	static String join(String separator, double... array) Returns a string containing the supplied double values, converted to strings as specified by Double.toString(double), and separated by separator.
11	static int lastIndexOf(double[] array, double target) Returns the index of the last appearance of the value target in array.
12	static Comparator<double[]> lexicographicalComparator() Returns a comparator that compares two double arrays lexicographically.
13	static double max(double... array) Returns the greatest value present in array, using the same rules of comparison as Math.max(double, double).
14	static double min(double... array) Returns the least value present in array, using the same rules of comparison as Math.min(double, double).
15	static Converter<String,Double> stringConverter() Returns a serializable converter object that converts between strings and doubles using Double.valueOf(java.lang.String) and Double.toString().
16	static double[] toArray(Collection<? extends Number> collection) Returns an array containing each value of collection, converted to a double value in the manner of Number.doubleValue().
17	static Double tryParse(String string) Parses the specified string as a double-precision floating point value.

Methods Inherited

This class inherits methods from the following class:

• java.lang.Object

Example of Doubles Class

Create the following java program using any editor of your choice in say C:/> Guava.

GuavaTester.java

Verify the Result

Compile the class using javac compiler as follows:


Now run the GuavaTester to see the result.


See the result.


Chars Class

Chars is a utility class for primitive type char.

Class Declaration

Following is the declaration for com.google.common.primitives.Chars class:


Fields

S.N.	Field & Description
1	static int BYTES The number of bytes required to represent a primitive char value.

Methods

S.N.	Method & Description
1	static List<Character> asList(char... backingArray) Returns a fixed-size list backed by the specified array, similar to Arrays.asList(Object[]).
2	static char checkedCast(long value) Returns the char value that is equal to value, if possible.
3	static int compare(char a, char b) Compares the two specified char values.
4	static char[] concat(char[]... arrays) Returns the values from each provided array combined into a single array.
5	static boolean contains(char[] array, char target) Returns true if target is present as an element anywhere in array.
6	static char[] ensureCapacity(char[] array, int minLength, int padding) Returns an array containing the same values as array, but guaranteed to be of a specified minimum length.
7	static char fromByteArray(byte[] bytes) Returns the char value whose big-endian representation is stored in the first 2 bytes of bytes; equivalent to ByteBuffer.wrap(bytes).getChar().
8	static char fromBytes(byte b1, byte b2) Returns the char value whose byte representation is the given 2 bytes, in big-endian order; equivalent to Chars.fromByteArray(new byte[] {b1, b2}).
9	static int hashCode(char value) Returns a hash code for value; equal to the result of invoking ((Character) value).hashCode().
10	static int indexOf(char[] array, char target) Returns the index of the first appearance of the value target in array.
11	static int indexOf(char[] array, char[] target) Returns the start position of the first occurrence of the specified target within array, or -1 if there is no such occurrence.
12	static String join(String separator, char... array) Returns a string containing the supplied char values separated by separator.
13	static int lastIndexOf(char[] array, char target) Returns the index of the last appearance of the value target in array.
14	static Comparator<char[]> lexicographicalComparator() Returns a comparator that compares two char arrays lexicographically.
15	static char max(char... array) Returns the greatest value present in array.
16	static char min(char... array) Returns the least value present in array.
17	static char saturatedCast(long value) Returns the char nearest in value to value.
18	static char[] toArray(Collection<Character> collection) Copies a collection of Character instances into a new array of primitive char values.
19	static byte[] toByteArray(char value) Returns a big-endian representation of value in a 2-element byte array; equivalent to ByteBuffer.allocate(2).putChar(value).array().

Methods Inherited

This class inherits methods from the following class:

• java.lang.Object

Example of Chars Class

Create the following java program using any editor of your choice in say C:/> Guava.

GuavaTester.java

Verify the Result

Compile the class using javac compiler as follows:


Now run the GuavaTester to see the result.


See the result.


Booleans Class

Booleans is a utility class for primitive type Boolean.

Class Declaration

Following is the declaration for com.google.common.primitives.Booleans class:


Methods

S.N.	Method & Description
1	static List<Boolean> asList(boolean... backingArray) Returns a fixed-size list backed by the specified array, similar to Arrays.asList(Object[]).
2	static int compare(boolean a, boolean b) Compares the two specified boolean values in the standard way (false is considered less than true).
3	static boolean[] concat(boolean[]... arrays) Returns the values from each provided array combined into a single array.
4	static boolean contains(boolean[] array, boolean target) Returns true if target is present as an element anywhere in array.
5	static int countTrue(boolean... values) Returns the number of values that are true.
6	static boolean[] ensureCapacity(boolean[] array, int minLength, int padding) Returns an array containing the same values as array, but guaranteed to be of a specified minimum length.
7	static int hashCode(boolean value) Returns a hash code for value; equal to the result of invoking ((Boolean) value).hashCode().
8	static int indexOf(boolean[] array, boolean target) Returns the index of the first appearance of the value target in array.
9	static int indexOf(boolean[] array, boolean[] target) Returns the start position of the first occurrence of the specified target within array, or -1 if there is no such occurrence.
10	static String join(String separator, boolean... array) Returns a string containing the supplied boolean values separated by separator.
11	static int lastIndexOf(boolean[] array, boolean target) Returns the index of the last appearance of the value target in array.
12	static Comparator<boolean[]> lexicographicalComparator() Returns a comparator that compares two boolean arrays lexicographically.
13	static boolean[] toArray(Collection<Boolean> collection) Copies a collection of Boolean instances into a new array of primitive boolean values.

Methods Inherited

This class inherits methods from the following class:

• java.lang.Object

Example of Booleans Class

Create the following java program using any editor of your choice in say C:/> Guava.

GuavaTester.java


Verify the Result

Compile the class using javac compiler as follows:


Now run the GuavaTester to see the result.


See the result.

---