Open In App

Charset forName() method in Java with Examples

Improve
Improve
Like Article
Like
Save
Share
Report

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 function
import 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 function
import 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 function
import 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 function
import 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)



Last Updated : 29 Mar, 2019
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads