J2SE 1.5 中的Formatter 类

原创 2005年06月01日 00:42:00
作者:Jeff Langr
出处:developer.com

Java 1.5 introduces a new class named java.util.Formatter that allows you to do string formatting similar to the printf function in C. It depends heavily on the varargs feature being introduced in 1.5.

System.out.printf


The first way you'll learn to work with the Formatter is not to interact with it directly, but instead to use the new PrintStream method printf. You're probably most familiar with PrintStream from doing System.out.println calls. Here is a simple example of the new printf method:

  1. String initials = "jjl";
  2. String comment  = "just because";
  3. System.out.printf("reason: %s (noted by %s)", comment, initials);


The example prints the following output on the console:

reason: just because (noted by jjl)
In the example code, you are passing printf a format string that contains embedded format specifiers. You also pass it a list of arguments, each of which corresponds to a format specifier. There are two format specifiers in the example: %s and %s. The first corresponds to the comment argument, and the second corresponds to the initials argument.

A % in a format string designates the start of a format specifier. The end of a format specifier is triggered by one of many possible characters known as conversions. In the %s format specifier, the lowercase s indicates a String conversion. A string conversion means that Java calls toString on the corresponding argument, and substitutes the result for the format specifier.

String.format


If you only want to obtain a formatted string, but not print it, you can use the static method format on the String class. Here's an example that also demonstrates a few numeric conversions:

  1. int a = 65;
  2. String s = 
  3.    String.format("char: %c integral: %d octal: %o hex: %x %n",
  4.       a, a, a, a);


The %n at the end of the format string indicates a platform-specific line separator. When printed, the String s looks like this:

char: A integral: 65 octal: 101 hex: 41
Numeric conversions also support flags for padding, grouping, justification, and sign.

Note: There are four arguments, each using the reference a. Were you to supply only three, or were one of the arguments an invalid type (for example, a string), the format method would have generated one of a few runtime exceptions. This is unlike C, which ignores any formatting problems.

If you want to use the same argument more than once against a format string, you can use a shortcut:

  1. String s = String.format("char: %c integral:%<d octal: %<o hex: %<x %n", a);


The a reference is specified only once. The less-than sign (<) in a format specifier means that it should use the same argument as the last format specifier.

Dates


Formatter provides an extensive number of date-related conversions. The following code:

  1. String.format("%1$td %1$tb %1$ty"new Date())


produces a string with the value:

26 Feb 04
The 1$ in each format specifier is another way to designate which argument to use. In this example, all three format specifiers target the first argument.

The last part of each format specifier is how you do date conversions?using a two-character sequence starting with a t. The second character indicates the date part to convert. For example, td in the first specifier converts the day of the month.

java.util.Formatter


The Formatter class is at the core of the new formatting capability. It fully supports internationalization by letting you pass a Locale to the constructor; the other formatting methods (e.g. String.format) also allow this.

Formatter also lets you pass an Appendable object. This is a new interface that defines append methods so that the formatter can store its results in a text collector such as a stream object. Sun has modified all relevant Java classes, such as StringBuffer and PrintStream, to implement this interface. Here's how you might use it:

  1. double avogadro     = 6.0e23;
  2. StringBuffer buffer = new StringBuffer();
  3. Formatter formatter = new Formatter(buffer, Locale.US);
  4. formatter.format("avogadro's number: %e %n", avogadro);
  5. formatter.format("base of the natural log: %e %n"Math.E);
  6. System.out.println(buffer.toString());


The corresponding output:

[pre]avogadro's number:       6.000000e+23
base of the natural log: 2.718282e+00[/pre]

Summary


There are dozens of conversions available in the Formatter class and a few more things that are not covered here. To learn more about formatting, refer to the Java API documentation pages for java.util.Formatter.

Trying It Out


You can download the current beta version of J2SE 1.5 from Sun's Web site.

About the Author


Jeff Langr is a freelance author and the owner of Langr Software Solutions. He is working on a second book on Java and test-driven development entitled Agile Java, due out from Prentice Hall in fall 2004.

体验J2SE 1.5新特性之增强For循环

1.5提供了另一种形式的for循环。借助这种形式的for循环,可以用更简单地方式来遍历数组和Collection等类型的对象。本文介绍使用这种循环的具体方式,说明如何自行定义能被这样遍历的类,并解释和...
  • ergouge
  • ergouge
  • 2012年05月05日 00:02
  • 359

J2SE 1.5提供了另一种形式的for循环

J2SE 1.5提供了另一种形式的for循环。借助这种形式的for循环,可以用更简单地方式来遍历数组和Collection等类型的对象。本文介绍使用这种循环的具体方式,说明如何自行定义能被这样遍历的类...

[J2SE 1.5]逐渐挖掘Varargs(Object... params)

Object... params简单点来说就是说可以有任意多个Object类型的参数,也就是说可以传递0到多个Object类或子类的对象到这个方法。 转载地址:http://blog.csdn.ne...

J2SE 1.5新特性之增强For循环

J2SE 1.5提供了另一种形式的for循环。借助这种形式的for循环,可以用更简单地方式来遍历数组和Collection等类型的对象。本文介绍使用这种循环的具体方式,说明如何自行定义能被这样遍历的类...
  • nengyu
  • nengyu
  • 2011年07月22日 17:01
  • 405

用 J2SE1.5 建立多任务的Java应用程序

J2SE 5.0中的java.util.concurrent程序包提供了一个新的线程框架组件,这个框架组件处理了与建立、执行和管理线程相关的很多低层细节信息。在本文中我们将细致地了解一下它的重要特性。...

J2SE 1.5Varargs机制(Object... params)

http://blog.csdn.net/shihuan830619/article/details/6045339 J2SE 1.5提供了“Varargs”机制。借助这一机制,可以定义能和...

【J2SE归档总结】0x10 JDK1.5新特性

JDK1.5新特性: 泛型(Generics)为集合(collections)提供编译时类型安全,无需每刻从Collections取得一个对象就进行强制转换(cast) 增强的“for”循环(En...
  • WCG_BOY
  • WCG_BOY
  • 2012年12月17日 23:12
  • 326

maven2 环境警告 j2se-1.5

Build path specifies execution environment J2SE-1.5. There are no JREs installed in the workspace th...
  • lxhjh
  • lxhjh
  • 2013年10月28日 13:45
  • 1113

j2se1.5中文api

  • 2006年06月27日 10:07
  • 26.44MB
  • 下载

Collections &amp; Generics in J2SE 1.5

  • 2008年12月05日 10:26
  • 464KB
  • 下载
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:J2SE 1.5 中的Formatter 类
举报原因:
原因补充:

(最多只允许输入30个字)