Java中的格式化输出,Formatter类的介绍

转载原文链接:http://www.itzhai.com/java-notes-java-in-the-formatted-output-formatter-class-presentation.html

我们知道C语言中有printf()这样的格式化函数,类似这样的:

printf("data: [%d %f]\n", x, y);
1、Java中也提供了类似的格式化方法:System.out.format();

Java SE5引入的format方法可以用于PrintStream或PrintWriter对象(这里不介绍了),其中也包括System.out,下面就是一个使用例子:

int x = 1;
double y = 3.1415926;
System.out.format("data: [%d %f]\n", x, y);

得到如下结果:

data: [1 3.141593]
2、Formatter类:

在Java中所有新的格式化功能都由java.util.Formatter类处理。可将Formatter看做一个翻译器,将你的字符串翻译成需要的结果。

构造Formatter的时候,需要向其构造器传递一些信息,告诉最终的结果将向哪里输出:

public class Message{
    private String username;
    private Formatter f;
    public Message(String username, Formatter f){
        this.username = username;
        this.f = f;
    }
    public void publishMsg(int hour, int minute){
        f.format("%s says it is %d:%d\n", username, hour, minute);
    }
    public static void main(String[] args){
        Message msg1 = new Message("Jason",
                new Formatter(System.out)); // 传入System.out,信息输出到此
        msg1.publishMsg(10, 12);

        Message msg2 = new Message("Jason",
                new Formatter(System.err)); // 当然,也可以传入System.err
        msg2.publishMsg(10, 13);

    }
}

得到如下结果:

Jason says it is 10:12
Jason says it is 10:13

上例是向Formatter传入了PrintStream,Formatter的构造器经过重载可以接受多种输出目的地,如OutputStream和File(这里不作介绍)。

格式化说明符:

format字符串的格式化参数语法如下:

%[argument_index$][flags][width][.precision]conversion

argument_index$:argument_index 是一个十进制整数,用于表明参数在参数列表中的位置。第一个参数由 “1$” 引用,第二个参数由 “2$” 引用,依此类推。

flags:可选 flags 是修改输出格式的字符集。有效标志集取决于转换类型。

width:控制一个域的最小值,默认情况下下是右对齐的,可以通过使用“-”标志来改变对其方向。

precision:精度,用于String时,表示输出字符的最大数量,用于浮点数时,表示小数部分要显示出来的 位数(默认是6位),多则舍入,少则补0,用于整数会触发异常。

conversion:转换格式,可选的格式有:

d 整数型(十进制)
c Unicode字符
b Boolean值
s String
f 浮点数(十进制)
e 浮点数(科学计数)
x 整数(十六进制)
h 散列码
% 字符串“%”

注意当使用b作为转换格式时,即Boolean,对于boolean基本类型或者Boolean对象,其转换结果是对应的true或false。但是对于其他类型的参数,只要该参数不为null,那么该转换的结果就永远都是true。0也会转换为true的,跟其他语言有所区别。所以将b运用于非布尔类型要注意。

下面是一个使用例子:

public class TableData {

    // 格式化说明符的使用例子
    private Formatter f = new Formatter(System.out);
    public void printHead(){
        f.format("%-10s %5s %5s\n", "username", "level", "score");
        f.format("%-10s %5s %5s\n", "---", "---", "---");
    }
    public void printData(){
        f.format("%-10s %5d %5.2f\n", "Jason", 1, 9.87654321);
        f.format("%-10s %5d %5.2f\n", "arthinking", 2, 9.6512);
    }

    public static void main(String[] args){
        TableData tb = new TableData();
        tb.printHead();
        tb.printData();
    }
}

输出如下内容:

username   level score
---          ---   ---
Jason          1  9.88
arthinking     2  9.65

下面的boolean转换都输出为true:

Formatter f = new Formatter(System.out);
f.format("boolean %b: ", "false");
f.format("boolean %b: ", 0);
3、String.format();

String.format()的内部,也是创建了一个Formatter对象,然后将你传入的参数转给该Formatter。是一个static方法,接受的参数和Formatter.format()一样,但是返回了一个String对象,如果你只需要使用format()方法一次时,String.format()方法使用起来很方便。

String formatStr = String.format("%#4X", 12);
System.out.println(formatStr);

上面的输出为:

0XC

4表示域的长度,#是flags,具体参考这里:

标志

下表总结了受支持的标志。y 表示该标志受指示参数类型支持。

标志 常规 字符 整数 浮点 日期/时间 说明
‘-’ y y y y y 结果将是左对齐的。
‘#’ y1 - y3 y - 结果应该使用依赖于转换类型的替换形式
‘+’ - - y4 y - 结果总是包括一个符号
‘  ’ - - y4 y - 对于正值,结果中将包括一个前导空格
’0′ - - y y - 结果将用零来填充
‘,’ - - y2 y5 - 结果将包括特定于语言环境的组分隔符
‘(‘ - - y4 y5 - 结果将是用圆括号括起来的负数

1 取决于 Formattable 的定义。

2 只适用于 'd' 转换。

3 只适用于 'o''x' 和 'X' 转换。

4 对 BigInteger 应用 'd''o''x' 和 'X' 转换时,或者对 byte 及 Byteshort 及 Shortint 及 Integerlong 及 Long 分别应用 'd' 转换时适用。

5 只适用于 'e''E''f''g' 和 'G' 转换。

任何未显式定义为标志的字符都是非法字符,并且都被保留,以供扩展使用。

更多说明参考JDK文档。

发表评论

电子邮件地址不会被公开。 必填项已用 * 标注

*

您可以使用这些 HTML 标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>