- Guava Tutorial
- Guava - Home
- Guava - Overview
- Guava - Environment Setup
- Guava - Optional Class
- Guava - Preconditions Class
- Guava - Ordering Class
- Guava - Objects Class
- Guava - Range Class
- Guava - Throwables Class
- Guava - Collections Utilities
- Guava - Caching Utilities
- Guava - String Utilities
- Guava - Primitive Utilities
- Guava - Math Utilities
- Guava Useful Resources
- Guava - Quick Guide
- Guava - Useful Resources
- Guava - Discussion
Guava - Chars Class
Chars is a utility class for primitive type char.
Class Declaration
Following is the declaration for com.google.common.primitives.Chars class −
@GwtCompatible(emulated = true) public final class Chars extends Object
Fields
Sr.No | Field & Description |
---|---|
1 |
static int BYTES The number of bytes required to represent a primitive char value. |
Methods
Sr.No | 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
import java.util.List; import com.google.common.primitives.Chars; public class GuavaTester { public static void main(String args[]) { GuavaTester tester = new GuavaTester(); tester.testChars(); } private void testChars() { char[] charArray = {'a','b','c','d','e','f','g','h'}; //convert array of primitives to array of objects List<Character> objectArray = Chars.asList(charArray); System.out.println(objectArray.toString()); //convert array of objects to array of primitives charArray = Chars.toArray(objectArray); System.out.print("[ "); for(int i = 0; i< charArray.length ; i++) { System.out.print(charArray[i] + " "); } System.out.println("]"); //check if element is present in the list of primitives or not System.out.println("c is in list? " + Chars.contains(charArray, 'c')); //return the index of element System.out.println("c position in list " + Chars.indexOf(charArray, 'c')); //Returns the minimum System.out.println("Min: " + Chars.min(charArray)); //Returns the maximum System.out.println("Max: " + Chars.max(charArray)); } }
Verify the Result
Compile the class using javac compiler as follows −
C:\Guava>javac GuavaTester.java
Now run the GuavaTester to see the result.
C:\Guava>java GuavaTester
See the result.
[a, b, c, d, e, f, g, h] [ a b c d e f g h ] c is in list? true c position in list 2 Min: a Max: h