快速上手java.util.Formatter 类，(实例教程)

     因为工作需要，前段时间有用到java.util.Formatter类，  因为关于此类的api文档 可能会有一些难度，所以在这里用自己的方式给大家讲解一番，希望大家能快速上手。

    Q. 为什么要用到此类：

           A：此类提供了对布局对齐和排列的支持，以及对数值、字符串和日期/时间数据的常规格式和特定于语言环境的输出的支持。

                 通俗一点说就是  控制 输出文本的 格式。

1、产生格式化输出的每个方法都需要“格式字符串” 和 “参数列表”

         格式字符串是一个 String，它可以包含固定文本以及一个或多个嵌入的 “格式说明符。”

格式说明符的语法如下：

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

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

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

可选 width 是一个 非负十进制整数，表明要向输出中写入的最少字符数。

可选 precision 是一个非负十进制整数， 通常用来限制字符数。特定行为取决于转换类型。

所需的 conversion 是一个表明应该如何格式化参数的字符。给定参数的有效转换集合取决于参数的数据类型。

 

实例：

   package test; import java.util.Calendar; import java.util.Formatter; import java.util.Locale; public class JavaApiDemo { /** * @param args */ public static void main(String[] args) { // TODO Auto-generated method stub StringBuilder sb = new StringBuilder(); // Send all output to the Appendable object sb(将所有的 输出 发送到附加对象 sb ) /** Formatter(Appendable a, Locale l) 构造一个带指定目标文件和语言环境的新 formatter。*/ Formatter formatter = new Formatter(sb, Locale.US); // Explicit(详述的，明确的) argument indices(index的复数形式) may be used to re-order output. /** * 明确的 “参数索引”(eg. agurment_index$) 可以用来对 输出文本(参数列表) 进行排序 */ formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d"); // -> " d c b a" // Optional locale as the first argument can be used to get // locale-specific formatting of numbers. The precision(精度) and width can be // given to round and align the value. /** * 可选的local参数作为第一个参数 可以去 获取(或设定) 区域设置特定的数字格式 * 精度和宽度的设定 可以 全面对其所要输出的格式 */ formatter.format(Locale.FRANCE, "e = %+10.4f", Math.E); System.out.println(sb.toString()); // Writes a formatted string to System.out. System.out.format("Local time: %tT", Calendar.getInstance()); // -> "Local time: 13:34:18" } }

 

 

 解释：Formatter formatter = new Formatter(sb,Locale.US)  //构造一个带指定目标文件和语言环境的新 formatter，  所有的输出 将 发送 到 sb 对象中，  

          formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d ")  //  "%4$2s %3$2s %2$2s %1$2s"  是 “格式字符串”，后面的 是参数列表，

含 a ，b ， c ，d  四个参数 ，%4$2s  表示的意思是 4$:第四个参数， 2：最少输出两个字符,s：按照字符串的格式输出目标字符  。

              语法对照：   %[argument_index$][flags][width][.precision]conversion

像那个flags 参数 啊 ，是表示 控制 输出格式的 字符集，可以参照api文档的 《标志》 部分。

 eg.

'-'

y

y

y

y

y

结果将是左对齐的。

width 和 .precision  就不多说了，

 conversion  控制输出的 格式 语法，可以参考api文档的 《转换》 部分。

eg

'd'

整数

结果被格式化为十进制整数

     System.out.format("将参数列表当中的十进制整数转换成十六进制：29转换成十六进制之后的值：%1$x", 29);

控制台输出 将参数列表当中的十进制整数转换成十六进制：29转换成十六进制之后的值 1d