Character.digit() en Java con ejemplos

java.lang.Character.digit() es un método incorporado en Java que devuelve el valor numérico del carácter ch en la base especificada . Devuelve -1 si la base no está en el rango MIN_RADIX <= base <= MAX_RADIX o si el valor de ch no es un dígito válido en la base especificada. Un carácter es un dígito válido si al menos uno de los siguientes es verdadero:

• El método isDigit es verdadero para el carácter y el valor del dígito decimal Unicode del carácter (o su descomposición en un solo carácter) es menor que la raíz especificada. En este caso se devuelve el valor del dígito decimal.
• El carácter es una de las letras latinas mayúsculas de la ‘A’ a la ‘Z’ y su código es menor que radix + ‘A’ – 10. En este caso, se devuelve ch – ‘A’ + 10.
• El carácter es una de las letras latinas minúsculas de la ‘a’ a la ‘z’ y su código es menor que radix + ‘a’ – 10. En este caso, se devuelve ch – ‘a’ + 10.
• El carácter es una de las letras latinas mayúsculas de ancho completo de la A (‘\uFF21’) a la Z (‘\uFF3A’) y su código es menor que radix + ‘\uFF21’ – 10. En este caso, ch – ‘\uFF21’ + 10 se devuelve.
• El carácter es una de las letras latinas minúsculas de ancho completo de la a (‘\uFF41’) a la z (‘\uFF5A’) y su código es menor que radix + ‘\uFF41’ – 10. En este caso, ch – ‘\uFF41’ + 10 se devuelve.

Sintaxis:

public static int digit(char ch, int radix)

Parámetros: La función acepta dos parámetros que se describen a continuación:

• ch: este es un parámetro obligatorio que especifica el carácter que se va a convertir.
• radix: este es un parámetro obligatorio que especifica radix.

Valor devuelto: este método devuelve el valor numérico representado por el carácter en la base especificada.

Los siguientes programas demuestran el método anterior:

Programa 1:

// Java program to illustrate the
// Character.digit() method
  
import java.lang.*;
  
public class gfg {
  
    public static void main(String[] args)
    {
        // create and assign value
        // to 2 character objects
        char c1 = '3', c2 = '6';
  
        // assign the numeric value of c1 to in1 using radix
        int in1 = Character.digit(c1, 5);
        System.out.println("Numeric value of " + c1 + " in radix 5 is " + in1);
  
        // assign the numeric value of c2 to in2 using radix
        int in2 = Character.digit(c2, 15);
        System.out.println("Numeric value of " + c2 + " in radix 15 is " + in2);
    }
}

Numeric value of 3 in radix 5 is 3
Numeric value of 6 in radix 15 is 6

Programa 2:

// Java program to illustrate the
// Character.digit() method
// when -1 is returned
import java.lang.*;
  
public class gfg {
  
    public static void main(String[] args)
    {
  
        // create and assign value
        // to 2 character objects
        char c1 = 'a', c2 = 'z';
  
        // assign the numeric value of c1 to in1 using radix
        int in1 = Character.digit(c1, 5);
        System.out.println("Numeric value of " + c1 + " in radix 5 is " + in1);
  
        // assign the numeric value of c2 to in2 using radix
        int in2 = Character.digit(c2, 15);
        System.out.println("Numeric value of " + c2 + " in radix 15 is " + in2);
    }
}

Numeric value of a in radix 5 is -1
Numeric value of z in radix 15 is -1

Referencia : https://docs.oracle.com/javase/7/docs/api/java/lang/Character.html#digit(char,%20int)