Java二维数组格式化输出方法解析

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Java二维数组格式化输出技巧》，聊聊，我们一起来看看吧！

本文详细介绍了在Java中如何利用System.out.printf方法对控制台输出进行格式化，以实现二维数组数据的对齐显示。通过讲解格式化字符串中的类型和对齐修饰符，特别是%-Ns，读者将学会如何确保不同长度的字符串和数字在输出时保持整齐划一，从而提升程序的输出可读性和专业性。

在Java应用程序开发中，尤其是在控制台输出数据时，保持输出内容的整齐对齐对于提升用户体验和数据可读性至关重要。当处理如学生姓名和成绩这样的二维数组数据时，由于学生姓名的长度不一，直接使用简单的字符串拼接或System.out.println方法往往会导致输出的数字列无法对齐，使得信息难以快速浏览。

例如，考虑以下原始代码片段及其可能产生的不对齐输出：

public class GradeBook {
    public static void main(String[] args) {
        String[] STUDENT_NAMES = new String[] {"Adams", "Baker", "Campbell", "Dewey", "East"};
        int[][] STUDENT_GRADES = new int[5][3];

        loadGradeArray(STUDENT_GRADES); // 假设此方法已填充成绩数据

        for (int i = 0; i < STUDENT_NAMES.length; i++) {
            // 简单的字符串拼接或不带格式的printf
            System.out.printf("%s %d %d \n", STUDENT_NAMES[i], STUDENT_GRADES[i][0], STUDENT_GRADES[i][1]);
        }
    }

    public static void loadGradeArray(int[][] STUDENT_GRADES) {
        // 简化示例，实际代码中会填充具体成绩
        STUDENT_GRADES[0][0] = 75; STUDENT_GRADES[0][1] = 75;
        STUDENT_GRADES[1][0] = 100; STUDENT_GRADES[1][1] = 75;
        STUDENT_GRADES[2][0] = 84; STUDENT_GRADES[2][1] = 75;
        STUDENT_GRADES[3][0] = 80; STUDENT_GRADES[3][1] = 75;
        STUDENT_GRADES[4][0] = 50; STUDENT_GRADES[4][1] = 75;
    }
}

上述代码可能产生如下不对齐的输出：

Adams 75 75
Baker 100 75
Campbell 84 75
Dewey 80 75
East 50 75

可以看到，由于“Campbell”和“East”等姓名的长度不同，后面的成绩数字未能整齐对齐。为了解决这一问题，Java提供了System.out.printf方法，它允许开发者通过格式化字符串精确控制输出的布局。

使用 System.out.printf 进行格式化输出

System.out.printf 方法类似于C语言中的 printf，它接受一个格式化字符串和一系列参数。格式化字符串中包含普通字符和格式说明符（format specifiers），格式说明符以 % 开头，用于指示如何格式化对应的参数。

对于实现对齐，关键在于正确使用字符串的宽度和对齐修饰符。

核心格式说明符：

• %s: 用于格式化字符串。
• %d: 用于格式化整数。
• %-Ns: 用于格式化字符串，其中 N 是指定字段的总宽度。- 标志表示左对齐，如果字符串长度小于 N，则会在右侧填充空格；如果字符串长度超过 N，则会完整输出字符串而不会截断。
• %Ns: 用于格式化字符串，其中 N 是指定字段的总宽度。默认是右对齐，如果字符串长度小于 N，则会在左侧填充空格。

示例：对齐学生成绩簿

为了实现学生姓名左对齐，并且后续成绩数字能够整齐排列，我们可以将格式化字符串中的 %s 替换为 %-Ns。例如，如果我们希望学生姓名占用至少10个字符的宽度并左对齐，可以使用 %-10s。

以下是修改后的 GradeBook 代码，展示了如何利用 printf 实现对齐：

import java.util.*;
import java.io.*;

public class GradeBook {

    public static void main(String[] args) {
        System.out.println("Starting program\n\n");
        String[] STUDENT_NAMES = new String[] {"Adams", "Baker", "Campbell", "Dewey", "East"};
        int[][] STUDENT_GRADES = new int[5][3];

        loadGradeArray(STUDENT_GRADES);

        System.out.println("学生姓名   成绩1 成绩2"); // 添加表头
        System.out.println("--------------------"); // 分隔线

        for (int i = 0; i < STUDENT_NAMES.length; i++) {
            // 使用 %-10s 实现学生姓名左对齐，并占用10个字符宽度
            // 后续的 %d %d 之间留一个空格，确保成绩之间有间隔
            System.out.printf("%-10s %d %d \n", STUDENT_NAMES[i], STUDENT_GRADES[i][0], STUDENT_GRADES[i][1]);
        }
    } //end main

    public static void loadGradeArray(int[][] STUDENT_GRADES) {
        // 实际应用中，这些数据可能从文件或用户输入获取
        // 这里为了演示，直接硬编码赋值，注意原始代码的循环逻辑并未实际影响赋值
        STUDENT_GRADES[0][0] = 75;
        STUDENT_GRADES[0][1] = 75;
        STUDENT_GRADES[1][0] = 100;
        STUDENT_GRADES[1][1] = 75;
        STUDENT_GRADES[2][0] = 84;
        STUDENT_GRADES[2][1] = 75;
        STUDENT_GRADES[3][0] = 80;
        STUDENT_GRADES[3][1] = 75;
        STUDENT_GRADES[4][0] = 50;
        STUDENT_GRADES[4][1] = 75;
    }
}

输出结果：

Starting program


学生姓名   成绩1 成绩2
--------------------
Adams      75 75 
Baker      100 75 
Campbell   84 75 
Dewey      80 75 
East       50 75 

从输出可以看出，所有学生姓名都左对齐，并且成绩数字也整齐地排列在各自的列中，大大提高了输出的可读性。

注意事项与进阶用法

1. 字段宽度选择： N 的值应根据实际数据情况来确定。通常，可以设置为最长字符串的长度加上一些额外空间，以确保所有数据都能容纳且保持良好间距。如果字符串过长，超出指定宽度，printf 默认会完整输出字符串，可能导致超出预期宽度，但不会截断。
2. 右对齐数字： 如果希望数字也右对齐并占用固定宽度，可以使用 %Nd。例如，%3d 会将数字右对齐到3个字符的宽度。这对于确保多位数成绩（如两位数和三位数）的个位对齐非常有用。
3. 其他数据类型： printf 还支持其他数据类型的格式化，例如 %f 用于浮点数，%c 用于字符，%b 用于布尔值等。
4. 动态宽度： 在某些情况下，字段宽度可能需要根据运行时数据动态确定。可以通过 String.format 方法结合 String.length() 或遍历数据找出最大长度来实现。例如：

   int maxNameLength = 0;
   for (String name : STUDENT_NAMES) {
       if (name.length() > maxNameLength) {
           maxNameLength = name.length();
       }
   }
   // 留出一些额外空间，例如2个字符
   int fieldWidth = maxNameLength + 2;
   String formatString = String.format("%%-%ds %%d %%d %%n", fieldWidth);
   // 然后在循环中使用：System.out.printf(formatString, STUDENT_NAMES[i], ...);

   注意 formatString 中的 %% 是为了转义 % 字符本身，因为 String.format 也会解析格式化字符串。

5. 国际化： printf 方法还支持 Locale 参数，这对于处理不同地区数字、日期格式化非常有用。

总结

System.out.printf 是Java中一个强大且灵活的控制台输出工具，尤其擅长处理需要精确布局和对齐的场景。通过熟练掌握格式说明符，特别是 %-Ns 这样的宽度和对齐修饰符，开发者可以轻松地将原始、杂乱的输出转换为专业、易读的表格形式。这不仅提升了程序的可用性，也体现了良好的编程实践。在处理任何需要结构化文本输出的任务时，都应优先考虑使用 printf。

到这里，我们也就讲完了《Java二维数组格式化输出方法解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！