本文通過實(shí)例詳細(xì)介紹Java格式化輸出 System.out.printf() 方法的使用、參數(shù)的含義、格式轉(zhuǎn)換符使用時的注意事項(xiàng)。

1. printf API

// 使用指定的格式字符串和參數(shù)將格式化字符串寫入入到輸出流
public PrintStream printf(String format, Object ... args)
// 基于本地化環(huán)境使用指定的格式字符串和參數(shù)將格式化字符串寫入到輸出流
public PrintStream printf(Locale l, String format, Object ... args)

以上2個方法，當(dāng) format 為 null 時，拋出 NPE.

2. 參數(shù)說明

format

format 是以百分號(%) 開頭的格式說明字符串，具體格式如下

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

可選的 argument_index 是十進(jìn)制整數(shù)，表示參數(shù)列表中參數(shù)的位置。 第一個參數(shù)由“ 1$ ”引用，第二個由“ 2$ ” 引用 ，等等。 argument_index 必須緊跟 % 后面，并以 $ 結(jié)束。

note: 參數(shù)索引值從1開始，而不是從0開始， %1$ 對第一個參數(shù)格式化。這就避免了與0標(biāo)志混淆。

可選 flags 指定格式化輸出外觀的各種標(biāo)志。 有效標(biāo)志集取決于 conversion。

可選 width是正十進(jìn)制整數(shù)，表示要寫入到輸出的字符個數(shù)（注意對于浮點(diǎn)數(shù)：也包含小數(shù)點(diǎn)所占的1個字和 負(fù)數(shù)的負(fù)號所占的1個字符）。 當(dāng)實(shí)際字符數(shù)小于指定的寬度時，最前面用 flags 指定的標(biāo)志填充（若未指定，默認(rèn)用空格）。

eg: v=2.3, %5.2f 輸出 5.20 ，且前面包含1個空格。共打印5個字符，整數(shù)位1個5，1個小數(shù)點(diǎn)，2個精度，長度為4，比指定的寬度少1為，用1個前導(dǎo)空格代替。

可選 precision 是一個非負(fù)十進(jìn)制整數(shù)，通常用于限制字符數(shù)。 具體行為取決于轉(zhuǎn)換。

conversion （必需） 是一個字符，指示如何格式化參數(shù)。 給定參數(shù)的有效轉(zhuǎn)換集取決于參數(shù)的數(shù)據(jù)類型。

• 表1-用于printf flags(標(biāo)志) 說明

• 表2-用于printf conversion(轉(zhuǎn)換符) 說明

補(bǔ)充1: 使用 s 轉(zhuǎn)換符格式化任意的對象

可以使用 s 轉(zhuǎn)換符格式化任意的對象。 對于實(shí)現(xiàn)了 Formattable 接口的任意對象，將調(diào)用這個對象的 formatTo 方法；否則調(diào)用 toString 方法將這個對象轉(zhuǎn)換為字符串。

補(bǔ)充2: String.format()

使用 String.format() 方法可創(chuàng)建一個格式化的字符串，而不打印輸出。

API：

public static String format(String format, Object... args)
public static String format(Locale l, String format, Object... args)   

參數(shù)和 printf() 中的含義相同。

表3-日期和時間的轉(zhuǎn)換符

Note: 以下格式符已經(jīng)過時，對于新的代碼，應(yīng)當(dāng)使用 java.time 包的方法。

eg：

System.out.printf("%tc",new Date()); 

這條語句將用下面的格式打印當(dāng)前的日期和時間:

Mon Feb 09 18:05:19 PST 2015

下面的轉(zhuǎn)換符前面都必須用 t/T 修飾。

從上表可以看到，某些格式只給出了指定日期的部分信息。

例如，只有日期或月份。如果需要多次提供日期來分別格式化每一部分就太笨拙了。

為此，可以用一個格式字符串指示要格式化的參數(shù)索引。

索引必須緊跟在％后面，并以＄終止。

例如，

System.out.printf("%1$s %2$tB %2$te, %2$tY","Due date:",new Date());

會打印

Due date: February 9, 2015

還可以選擇使用<標(biāo)志。它指示前面格式說明中的參數(shù)將被再次使用。也就是說，以下語句將產(chǎn)生與前面語句同樣的輸出結(jié)果:

System.out.printf("%1$s %tB %<te, %<tY","Due date:",new Date());

args

args : 格式字符串中格式說明符引用的參數(shù)。

如果參數(shù)多于格式說明符，則忽略額外參數(shù)。

參數(shù)的數(shù)量是可變的，可以為零。

參數(shù)的最大數(shù)量受The Java Virtual Machine Specification（java虛擬機(jī)規(guī)范）定義的Java數(shù)組的最大維數(shù)限制。

null參數(shù)上的行為取決于 conversion（轉(zhuǎn)換符） 。

locale

數(shù)字和日期的格式化規(guī)則是特定于本地化環(huán)境的。

例如，在德國，分組分隔符是點(diǎn)號而不是逗號，另外 Monday被格式化為 Montag。

locale主要用于如何控制應(yīng)用的國際化行為。

3.printf 使用實(shí)例

// +199 199 c7 307 0xc7 0307
System.out.printf("%+d %<d %<x %<o %<#x %<#o\n",199);
// | 23| |23|
System.out.printf("|% d| |%<d|\n",23);
// hello 第5個字符是o,that's true
System.out.printf("%s 第%d個字符是%c,that's %b\n","hello",5,'o',true);
// 15 % 6 = 3
System.out.printf("%2$d %% %1$d = %3$d\n",6,15, 15 % 6);
// |  7.33| |007.33| |7.330000| 0x1.d51eb851eb852p2
System.out.printf("|%6.2f| |%0<6.2f| |%<f| %<a\n",7.33);
// | 211.79| |211.79 |
System.out.printf("|%7.2f| |%<-7.2f|\n",211.79);
// | -211.79| |(211.79)| |(-211.79)|
System.out.printf("|%8.2f| |%<(8.2f| |(%<.2f)|\n",-211.79);
// |-21171.3333| |-21,171.3333| |-2.1171e+04| |-2.117e+04|
System.out.printf("|%.4f| |%<,.4f| |%<.4e| |%<.4g|\n",-21171.3333);
String str = new String("tree");
// Note: %h 格式符輸出對象的散列碼 和 調(diào)用對象的hashCode 得到的值并不相同
// obj %h formatinput: 36739e,hashCode:3568542
System.out.printf("obj %%h formatinput: %h,hashCode:%s\n",str,str.hashCode());
// true 25 0.0032 含
System.out.printf("%s %s %s %s\n",true,25,3.2e-3,'含');
System.out.printf("|%n| \n","world");
System.out.printf("|%n| \n");

輸出

+199 199 c7 307 0xc7 0307
| 23| |23|
hello 第5個字符是o,that's true
15 % 6 = 3
|  7.33| |007.33| |7.330000| 0x1.d51eb851eb852p2
| 211.79| |211.79 |
| -211.79| |(211.79)| |(-211.79)|
|-21171.3333| |-21,171.3333| |-2.1171e+04| |-2.117e+04|
obj %h formatinput: 36739e,hashCode:3568542
true 25 0.0032 含
|
| 
|
| 

關(guān)于printf 轉(zhuǎn)換符使用的注意事項(xiàng)

• 適用于浮點(diǎn)類型轉(zhuǎn)換符（e,g,a,f）不能用于整形; 同樣適用于整形的轉(zhuǎn)換符（d,o,x）不能用于浮點(diǎn)型。
• 可以使用 s 轉(zhuǎn)換符格式化任意的對象。對于實(shí)現(xiàn)了 Formattable 接口的任意對象，將調(diào)用這個對象的 formatTo 方法；否則調(diào)用 toString 方法將這個對象轉(zhuǎn)換為字符串。

eg：

// test in jdk 8,11,14
// Exception in thread "main" java.util.IllegalFormatConversionException: o != java.lang.Float
System.out.printf("%o\n",2.3f);
// Exception in thread "main" java.util.IllegalFormatConversionException: f != java.lang.Integer
System.out.printf("%f\n",25);

總結(jié)

以上為個人經(jīng)驗(yàn)，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論