java Long.toOctalString返回八进制字符串

java.lang.Long.toOctalString(long i) 是 Java 中用于将 long 类型整数转换为八进制（基数为 8）字符串表示的静态方法。它在数据编码、权限表示（如 Unix 文件权限）、底层系统编程和教学演示中非常有用。

一、方法定义

public static String toOctalString(long i)

类：java.lang.Long
参数：long i —— 要转换的长整型数值
返回值：表示该 long 值的八进制（以 8 为基数）的无符号字符串
异常：无
自版本：JDK 1.0

🔗 相关方法：

toBinaryString(long i)：转二进制

toHexString(long i)：转十六进制

toString(long i, int radix)：通用进制转换

二、功能说明

将一个 long 类型的有符号整数，转换为其对应的无符号八进制字符串。
负数采用补码形式表示，转换时视为无符号处理，因此不会出现负号 -。
八进制数使用字符 0 到 7 表示。
结果不带前缀（如 0o 或 0），如需前缀需手动添加。

三、示例代码

public class LongToOctalStringExample {
    public static void main(String[] args) {
        // 正数示例
        System.out.println(Long.toOctalString(8));     // 输出: 10
        System.out.println(Long.toOctalString(64));    // 输出: 100
        System.out.println(Long.toOctalString(255));   // 输出: 377

        // 零
        System.out.println(Long.toOctalString(0));     // 输出: 0

        // 负数（以补码形式转换为无符号八进制）
        System.out.println(Long.toOctalString(-1));    // 输出: 1777777777777777777777
        System.out.println(Long.toOctalString(-8));    // 输出: 1777777777777777777770

        // 大整数
        System.out.println(Long.toOctalString(1_000_000_000L)); // 输出: 7346545000
    }
}

输出解释：

8 → 10₈（1×8¹ + 0×8⁰）
64 → 100₈（1×8²）
-1 → 全 1 的二进制（64 位），每 3 位转为八进制 → 1777...777（22 位）

四、使用技巧

1. 添加八进制前缀（如 `0o`）

String oct = "0o" + Long.toOctalString(64); // "0o100"

⚠️ Java 7+ 支持 0o100 字面量，但 toOctalString() 不自带。

2. 格式化输出（补零到固定位数）

String padded = String.format("%12s", Long.toOctalString(255))
                   .replace(' ', '0'); // "000000000377"

3. 与 `toString(radix)` 等价写法

String oct1 = Long.toOctalString(100);
String oct2 = Long.toString(100, 8); // 完全等价

4. 权限模拟（类 Unix）

long permission = 0755L; // 八进制字面量
String permStr = Long.toOctalString(permission); // "755"

五、常见错误

错误	说明
误解负数输出	以为会输出 `-10`，实际是补码的无符号八进制，非常长
缺少前缀混淆	输出 `10` 不知是八进制还是十进制
期望自动补零	方法不补零，需手动格式化
与进制混淆	误将八进制当十六进制使用

示例错误理解：

// ❌ 错误：以为 toOctalString(-1) 会是 "-1" 或 "-1"
System.out.println(Long.toOctalString(-1)); 
// 实际输出：1777777777777777777777（64 位全 1 的八进制）

六、注意事项

✅ 负数无符号处理：所有位都参与转换，结果为正字符串。
⚠️ 无前缀：返回纯数字字符串，不带 0 或 0o。
⚠️ 大数输出长：64 位最大八进制数有 22 位（777...777）。
✅ 线程安全：静态无状态方法，可并发调用。
❗ 不验证输入：任何 long 值都合法，包括 Long.MIN_VALUE。

七、最佳实践

明确用途再使用
- 仅在需要八进制表示时使用（如权限、教学、协议）。
- 一般业务建议用十进制或十六进制。

添加前缀提高可读性

String oct = "0o" + Long.toOctalString(value);

负数转换需注释说明

// 负数以补码形式转八进制
String negOct = Long.toOctalString(-1); // 1777...

结合 valueOf() 反向转换

long original = Long.valueOf("755", 8); // 从八进制字符串转回

避免在高频路径频繁调用
- 虽然性能良好，但字符串生成有开销，可缓存不变结果。

八、性能优化

避免重复转换

// ❌
for (int i = 0; i < 1000; i++) {
    System.out.println(Long.toOctalString(255));
}

// ✅ 缓存结果
String oct = Long.toOctalString(255);
for (int i = 0; i < 1000; i++) {
    System.out.println(oct);
}

使用 StringBuilder 拼接

StringBuilder sb = new StringBuilder();
sb.append("Mode: 0o").append(Long.toOctalString(mode));

toString(radix) 更通用但稍慢
- toOctalString() 是专用优化方法，比 toString(i, 8) 略快。
大数转换考虑替代方案
- 若用于展示，考虑分段处理或格式化工具。

九、总结

特性	说明
方法	`Long.toOctalString(long i)`
用途	将 `long` 转为八进制字符串
安全性	无异常，负数转为无符号补码形式
性能	高效，JVM 内部优化
典型场景	权限表示、教学、底层协议、进制转换工具

核心要点：

✅ 正数转换直观：8 → "10"，64 → "100"。
⚠️ 负数输出长串：基于补码，无负号，如 -1 → "1777..."。
🔧 无前缀：建议手动添加 0o 提高可读性。
🔁 可逆操作：用 Long.parseLong(str, 8) 或 valueOf(str, 8) 转回。
🚀 性能良好：适合一般用途，避免在热点循环中频繁生成。