All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class Acme.Fmt

java.lang.Object
   |
   +----Acme.Fmt

public class Fmt
extends Object

Some simple single-arg sprintf-like routines.

It is apparently impossible to declare a Java method that accepts variable numbers of any type of argument. You can declare it to take Objects, but numeric variables and constants are not in fact Objects.

However, using the built-in string concatenation, it's almost as convenient to make a series of single-argument formatting routines.

Fmt can format the following types:

byte short int long float double char String Object

For each type there is a set of overloaded methods, each returning a formatted String. There's the plain formatting version:

 Fmt.fmt( x )

There's a version specifying a minimum field width:

 Fmt.fmt( x, minWidth )

And there's a version that takes flags:

 Fmt.fmt( x, minWidth, flags )

Currently available flags are:

 Fmt.ZF - zero-fill
 Fmt.LJ - left justify
 Fmt.HX - hexadecimal
 Fmt.OC - octal

The HX and OC flags imply unsigned output.

For doubles and floats, there's a significant-figures parameter before the flags:

 Fmt.fmt( d )
 Fmt.fmt( d, minWidth )
 Fmt.fmt( d, minWidth, sigFigs )
 Fmt.fmt( d, minWidth, sigFigs, flags )

Fetch the software.
Fetch the entire Acme package.

Similar classes:

Andrew Scherpbier's FormatString Tries to allow variable numbers of arguments by supplying overloaded routines with different combinations of parameters, but doesn't actually supply that many. The floating point conversion is described as "very incomplete".
Core Java's Format. The design seems a little weird. They want you to create an instance, passing the format string to the constructor, and then call an instance method with your data to do the actual formatting. The extra steps are pointless; better to just use static methods.

HX: Hexadecimal.
LJ: Left justify.
OC: Octal.
ZF: Zero-fill.

Fmt()

doubleToString(double): Improved version of Double.toString(), returns more decimal places. Deprecated.
fmt(byte)
fmt(byte, int)
fmt(byte, int, int)
fmt(char)
fmt(char, int)
fmt(char, int, int)
fmt(double)
fmt(double, int)
fmt(double, int, int)
fmt(double, int, int, int)
fmt(float)
fmt(float, int)
fmt(float, int, int)
fmt(float, int, int, int)
fmt(int)
fmt(int, int)
fmt(int, int, int)
fmt(long)
fmt(long, int)
fmt(long, int, int)
fmt(Object)
fmt(Object, int)
fmt(Object, int, int)
fmt(short)
fmt(short, int)
fmt(short, int, int)
fmt(String)
fmt(String, int)
fmt(String, int, int)

 public static final int ZF

Zero-fill.

 public static final int LJ

Left justify.

 public static final int HX

Hexadecimal.

 public static final int OC

Octal.

Fmt

 public Fmt()

fmt

 public static String fmt(byte b)

fmt

 public static String fmt(byte b,
                          int minWidth)

fmt

 public static String fmt(byte b,
                          int minWidth,
                          int flags)

fmt

 public static String fmt(short s)

fmt

 public static String fmt(short s,
                          int minWidth)

fmt

 public static String fmt(short s,
                          int minWidth,
                          int flags)

fmt

 public static String fmt(int i)

fmt

 public static String fmt(int i,
                          int minWidth)

fmt

 public static String fmt(int i,
                          int minWidth,
                          int flags)

fmt

 public static String fmt(long l)

fmt

 public static String fmt(long l,
                          int minWidth)

fmt

 public static String fmt(long l,
                          int minWidth,
                          int flags)

fmt

 public static String fmt(float f)

fmt

 public static String fmt(float f,
                          int minWidth)

fmt

 public static String fmt(float f,
                          int minWidth,
                          int sigFigs)

fmt

 public static String fmt(float f,
                          int minWidth,
                          int sigFigs,
                          int flags)

fmt

 public static String fmt(double d)

fmt

 public static String fmt(double d,
                          int minWidth)

fmt

 public static String fmt(double d,
                          int minWidth,
                          int sigFigs)

fmt

 public static String fmt(double d,
                          int minWidth,
                          int sigFigs,
                          int flags)

fmt

 public static String fmt(char c)

fmt

 public static String fmt(char c,
                          int minWidth)

fmt

 public static String fmt(char c,
                          int minWidth,
                          int flags)

fmt

 public static String fmt(Object o)

fmt

 public static String fmt(Object o,
                          int minWidth)

fmt

 public static String fmt(Object o,
                          int minWidth,
                          int flags)

fmt

 public static String fmt(String s)

fmt

 public static String fmt(String s,
                          int minWidth)

fmt

 public static String fmt(String s,
                          int minWidth,
                          int flags)

doubleToString

 public static String doubleToString(double d)

Note: doubleToString() is deprecated.

Improved version of Double.toString(), returns more decimal places.

The JDK 1.0.2 version of Double.toString() returns only six decimal places on some systems. In JDK 1.1 full precision is returned on all platforms.

See Also:: toString

All Packages  Class Hierarchy  This Package  Previous  Next  Index

ACME Java  ACME Labs