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)
