java Long.decode将十进制、十六进制或八进制数字解析为 `Long` 对象

Long.decode(String nm) 是 java.lang.Long 类中的一个静态方法，用于将包含十进制、十六进制或八进制数字的字符串解析为 Long 对象。它比 Long.parseLong() 更灵活，因为它能自动识别数字的进制前缀。

📚 一、方法定义

public static Long decode(String nm) throws NumberFormatException

• 参数：

  • nm：表示数字的字符串。支持以下格式：
    • 十进制：123、-456
    • 十六进制：0x123、0X123、#123
    • 八进制：0123（以 0 开头）

• 返回值：

  • 返回一个 Long 对象，表示解析出的 long 值。

• 异常：

  • NumberFormatException：如果字符串格式不合法或超出 long 范围。

✅ 二、支持的格式详解

⚠️ 注意：decode() 不支持二进制格式（如 0b1010），二进制需使用 Long.parseLong("1010", 2)。

💡 三、示例代码

示例 1：基本使用

public class LongDecodeExample {
    public static void main(String[] args) {
        // 十进制
        System.out.println(Long.decode("123"));        // 123

        // 十六进制（0x 前缀）
        System.out.println(Long.decode("0x1F"));       // 31
        System.out.println(Long.decode("0XFF"));       // 255

        // 十六进制（# 前缀）
        System.out.println(Long.decode("#FF"));        // 255

        // 八进制（以 0 开头）
        System.out.println(Long.decode("012"));        // 10（八进制 12 = 十进制 10）

        // 负数
        System.out.println(Long.decode("-0x10"));      // -16
    }
}

示例 2：错误处理

public class DecodeErrorHandling {
    public static void main(String[] args) {
        String[] inputs = {
            "abc",      // 非数字
            "12.3",     // 小数（不支持）
            "",         // 空字符串
            null,       // null 值
            "0b1010"    // 二进制（不支持）
        };

        for (String input : inputs) {
            try {
                Long result = Long.decode(input);
                System.out.println(input + " -> " + result);
            } catch (NumberFormatException | NullPointerException e) {
                System.err.println("解析失败: " + input + " -> " + e.getClass().getSimpleName());
            }
        }
    }
}

输出：

解析失败: abc -> NumberFormatException
解析失败: 12.3 -> NumberFormatException
解析失败:  -> NumberFormatException
解析失败: null -> NullPointerException
解析失败: 0b1010 -> NumberFormatException

🛠️ 四、使用技巧

1. 解析颜色值（如 HTML 颜色码）

String colorHex = "#FF5733";
Long colorValue = Long.decode(colorHex);
System.out.println("颜色值: " + colorValue); // 16764723

2. 自动识别进制（无需手动判断）

String input = "0xFF"; // 用户输入可能是 0xFF, #FF, 123, 017 等
Long value = Long.decode(input); // 自动识别进制

3. 与 Long.valueOf() 和 parseLong() 对比

✅ 推荐：当你不确定输入是哪种进制，且包含 0x 或 # 前缀时，优先使用 decode()。

⚠️ 五、注意事项

1. 不支持二进制：

   • Long.decode("0b1010") 会抛出 NumberFormatException
   • 正确方式：Long.parseLong("1010", 2)

2. 空字符串或 null：

   • decode(null) 抛出 NullPointerException
   • decode("") 抛出 NumberFormatException

3. 前导空格：

   • 不支持空格，" 0xFF" 会失败
   • 可先调用 .trim()

4. 性能：

   • decode() 内部需要解析前缀，性能略低于 parseLong()，但在大多数场景下差异可忽略。

❌ 六、常见错误

🏆 七、最佳实践

📝 八、总结

✅ 一句话掌握：

用 Long.decode() 解析带 0x、# 或 0 前缀的整数字符串，自动识别进制，返回 Long 对象，适用于颜色值、配置解析等场景。