El método forName() es un método integrado de java.nio.charset que devuelve un objeto de juego de caracteres para el juego de caracteres con nombre. En esta función le pasamos un nombre canónico o un alias y se devuelve su respectivo nombre de juego de caracteres.
Sintaxis :
public static Charset forName?(String charsetName)
Parámetros : la función acepta un solo parámetro obligatorio charsetName que especifica el nombre canónico o el nombre de alias cuyo nombre de objeto se devolverá.
Valor devuelto : la función devuelve un objeto de juego de caracteres para el juego de caracteres nombrado.
Errores y excepciones : la función lanza tres excepciones como se muestra a continuación:
- IllegalCharsetNameException : se lanza si el nombre del conjunto de caracteres dado es ilegal
- IllegalArgumentException : se lanza si el charsetName dado es nulo
- UnsupportedCharsetException : se lanza si no hay soporte disponible para el juego de caracteres nombrado en esta instancia de la máquina virtual Java
A continuación se muestra la implementación de la función anterior:
Programa 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); } }
The name for ISO-2022-CN is ISO-2022-CN
Programa 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); } }
The name for UTF16 is UTF-16
Programa 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); } } }
The exception is: java.nio.charset.IllegalCharsetNameException:
Programa 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); } } }
The exception is: java.nio.charset.UnsupportedCharsetException: gopal
Referencia: https://docs.oracle.com/javase/10/docs/api/java/nio/charset/Charset.html#forName(java.lang.String)