Charset forName() method in Java with Examples

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)