Character.digit() 是 Java 中解析单个字符在指定进制下数值的静态方法,返回对应十进制整数值(无效时返回-1),需配合循环和权展开实现完整进制转换。

Character.digit() 是 Java 中用于将字符转换为对应进制下数字值的静态方法,它不负责“进制转换”本身,而是**解析单个字符在指定进制下的数值含义**。理解它的作用和边界,才能正确用于进制相关的字符处理。
作用:把字符映射成该进制下的整数值
该方法签名是:public static int digit(char ch, int radix)。它尝试将字符 ch 解释为 radix 进制(2–36)中的一个有效数字,并返回其对应的十进制整数值;如果字符在该进制下无效(如 'G' 在十六进制中合法,但在十进制中不合法),则返回 -1。
- '0'–'9' 在任意 ≥10 的进制中都表示 0–9
- 'a'/'A'–'z'/'Z' 在进制 ≥11 时依次表示 10、11、…,最多到 35(对应 'z' 或 'Z')
- 例如:Character.digit('F', 16) 返回 15;Character.digit('7', 8) 返回 7;Character.digit('8', 8) 返回 -1(八进制不含 '8')
不能直接做“进制转换”,但可作为基础工具
它本身不把“字符串"1A"转成十进制17”,也不把整数255转成十六进制字符串。但它常被用在手动实现进制解析或格式校验中:
用大白话操作当前项目的 Git/GitHub——配置 GitHub(装 gh CLI + 登录 + 建仓库)、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发(例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
- 写自定义的 parseInt(String s, int radix) 逻辑时,逐字符调用 digit() 获取每位数值,再按权展开(如
value = value * radix + Character.digit(ch, radix)) - 验证用户输入是否为合法的某进制字面量(如检查字符串中每个字符是否都能被 digit(ch, 2) 接受)
- 配合 Character.forDigit() 实现双向映射:一个转数值,一个转字符
注意进制范围与大小写兼容性
radix 必须在 2–36 之间,超出抛 IllegalArgumentException。方法对大小写不敏感——'a' 和 'A' 在十六进制下都返回 10。
- 进制为 2 时,只接受 '0'、'1'(大小写均可,但通常只有小写)
- 进制为 36 时,可接受 '0'–'9' 和 'a'–'z'(或 'A'–'Z'),覆盖全部 36 个符号
- 进制为 1 无意义,Java 不支持;radix=1 会直接抛异常
典型误用提醒
不要把它当作“进制转换函数”直接调用:
- ❌ Character.digit("1010", 2) —— 参数类型错误,第一个参数必须是 char,不是 String
- ❌ Character.digit('Z', 10) —— 返回 -1,但若未检查返回值就参与计算,会导致逻辑错误
- ✅ 正确用法是:遍历字符串每个 char,逐一调用并验证返回值是否 ≥0










