The forName() method is a built-in method of the java.nio.charset returns a charset object for the named charset. In this function we pass a canonical name or an alias and its respective charset name is returned.
Syntax:
public static Charset forName?(String charsetName)
Parameters: The function accepts a single mandatory parameter charsetName which specifies the canonical name or the alias name whose object name is to be returned.
Return Value: The function returns a charset object for the named charset.
Errors and Exceptions: The function throws three exceptions as shown below:
- IllegalCharsetNameException: It is thrown if the given charset name is illegal
- IllegalArgumentException : It is thrown if the given charsetName is null
- UnsupportedCharsetException : It is thrown if no support for the named charset is available in this instance of the Java virtual machine
Below is the implementation of the above function:
Program 1:
// Java program to demonstrate// the above functionimport java.nio.charset.Charset;import java.util.Iterator;import java.util.Map; public class GFG { public static void main(String[] args) { // Gets the charset Charset first = Charset.forName("ISO-2022-CN"); // Prints the object System.out.println("The name for ISO-2022-CN is " + first); }} |
Output:
The name for ISO-2022-CN is ISO-2022-CN
Program 2:
// Java program to demonstrate// the above functionimport java.nio.charset.Charset;import java.util.Iterator;import java.util.Map; public class GFG { public static void main(String[] args) { // Gets the charset Charset first = Charset.forName("UTF16"); // Prints the object System.out.println("The name for UTF16 is " + first); }} |
Output:
The name for UTF16 is UTF-16
Program 3
// Java program to demonstrate// the above functionimport java.nio.charset.Charset;import java.util.Iterator;import java.util.Map; public class GFG { public static void main(String[] args) { try { // Gets the charset Charset first = Charset.forName(""); // Prints the object System.out.println("The name for null is " + first); } catch (Exception e) { // Prints the exception System.out.println("The exception is: " + e); } }} |
Output:
The exception is: java.nio.charset.IllegalCharsetNameException:
Program 4
// Java program to demonstrate// the above functionimport java.nio.charset.Charset;import java.util.Iterator;import java.util.Map; public class GFG { public static void main(String[] args) { try { // Gets the charset Charset first = Charset.forName("gopal"); // Prints the object System.out.println("The name for gopal is " + first); } catch (Exception e) { // Prints the exception System.out.println("The exception is: " + e); } }} |
Output:
The exception is: java.nio.charset.UnsupportedCharsetException: gopal
Reference: https://docs.oracle.com/javase/10/docs/api/java/nio/charset/Charset.html#forName(java.lang.String)
