Chars is a utility class for primitive type char. It provides Static utility methods pertaining to char primitives, that are not already found in either Character or Arrays. All the operations in this class treat char values strictly numerically, i.e, they are neither Unicode-aware nor locale-dependent.
Declaration :
@GwtCompatible(emulated=true) public final class Chars extends Object
Below table shows the Field summary for Guava Chars Class :
Some of the methods provided by Guava Chars Class are :
Exceptions :
- checkedCast : IllegalArgumentException if value is greater than Character.MAX_VALUE or less than Character.MIN_VALUE
- min : IllegalArgumentException if array is empty.
- max : IllegalArgumentException if array is empty.
- fromByteArray : IllegalArgumentException if bytes has fewer than 2 elements.
- ensureCapacity : IllegalArgumentException if minLength or padding is negative.
- toArray : NullPointerException if collection or any of its elements is null.
Below table shows some other methods provided by Guava Chars Class :
Below given are some examples showing the implementation of methods of Guava Chars Class :
Example 1 :
// Java code to show implementation // of Guava Chars.asList() method import com.google.common.primitives.Chars; import java.util.*; class GFG { // Driver method public static void main(String[] args) { char arr[] = { 'g' , 'e' , 'e' , 'k' , 's' }; // Using Chars.asList() method which // converts array of primitives // to array of objects List<Character> myList = Chars.asList(arr); // Displaying the elements System.out.println(myList); } } |
Output :
[g, e, e, k, s]
Example 2 :
// Java code to show implementation // of Guava Chars.toArray() method import com.google.common.primitives.Chars; import java.util.*; class GFG { // Driver method public static void main(String[] args) { List<Character> myList = Arrays.asList( 'g' , 'e' , 'e' , 'k' , 's' ); // Using Chars.toArray() method which // converts a List of Chars to an // array of char char [] arr = Chars.toArray(myList); // Displaying the elements System.out.println(Arrays.toString(arr)); } } |
Output :
[g, e, e, k, s]
Example 3 :
// Java code to show implementation // of Guava Chars.concat() method import com.google.common.primitives.Chars; import java.util.*; class GFG { // Driver method public static void main(String[] args) { char [] arr1 = { 'g' , 'e' , 'e' }; char [] arr2 = { 'k' , 's' }; // Using Chars.concat() method which // combines arrays from specified // arrays into a single array char [] arr = Chars.concat(arr1, arr2); // Displaying the elements System.out.println(Arrays.toString(arr)); } } |
Output :
[g, e, e, k, s]
Example 4 :
// Java code to show implementation // of Guava Chars.contains() method import com.google.common.primitives.Chars; class GFG { // Driver method public static void main(String[] args) { char [] arr = { 'g' , 'e' , 'e' , 'k' , 's' }; // Using Chars.contains() method which // checks if element is present in array // or not System.out.println(Chars.contains(arr, 'g' )); System.out.println(Chars.contains(arr, 'm' )); } } |
output :
true false
Example 5 :
// Java code to show implementation // of Guava Chars.min() method import com.google.common.primitives.Chars; class GFG { // Driver method public static void main(String[] args) { char [] arr = { 'g' , 'e' , 'e' , 'k' , 's' }; // Using Chars.min() method System.out.println(Chars.min(arr)); } } |
Output :
e
Example 6 :
// Java code to show implementation // of Guava Chars.max() method import com.google.common.primitives.Chars; class GFG { // Driver method public static void main(String[] args) { char [] arr = { 'g' , 'e' , 'e' , 'k' , 's' }; // Using Chars.max() method System.out.println(Chars.max(arr)); } } |
Output :
s