com.jcorporate.expresso.core.misc
Class Format

java.lang.Object
  com.jcorporate.expresso.core.misc.Format

public class Format

extends Object

Author:

Michael Nash

Constructor Summary

Format(String s)
Formats a number in a printf format, like C

Method Summary

static double	atof(String s) Converts a string of digits to an double
static int	atoi(String s) Converts a string of digits (decimal, octal or hex) to an integer
static long	atol(String s) Converts a string of digits (decimal, octal or hex) to a long integer
String	form(char c) Formats a character into a string (like sprintf in C)
String	form(double x) Formats a double into a string (like sprintf in C)
String	form(long x) Formats a long integer into a string (like sprintf in C)
String	form(String s) Formats a string into a larger string (like sprintf in C)
static void	print(PrintStream s, String fmt, char x) prints a formatted number following printf conventions
static void	print(PrintStream s, String fmt, double x) prints a formatted number following printf conventions
static void	print(PrintStream s, String fmt, long x) prints a formatted number following printf conventions
static void	print(PrintStream s, String fmt, String x) prints a formatted number following printf conventions
static void	print(PrintWriter s, String fmt, double x) prints a formatted number following printf conventions
static void	print(PrintWriter s, String fmt, String x) prints a formatted number following printf conventions

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Format

public Format(String s)

Formats a number in a printf format, like C

Parameters:

s - the format string following printf format string The string has a prefix, a format code and a suffix. The prefix and suffix become part of the formatted output. The format code directs the formatting of the (single) parameter to be formatted. The code has the following structure

• a % (required)
• a modifier (optional)

  +

  forces display of + for positive numbers

  0

  show leading zeroes

  -

  align left in the field

  space

  prepend a space in front of positive numbers

  #

  use "alternate" format. Add 0 or 0x for octal or hexadecimal numbers. Don't suppress trailing zeroes in general floating point format.

• an integer denoting field width (optional)
• a period followed by an integer denoting precision (optional)
• a format descriptor (required)

  f

  floating point number in fixed format

  e, E

  floating point number in exponential notation (scientific format). The E format results in an uppercase E for the exponent (1.14130E+003), the e format in a lowercase e.

  g, G

  floating point number in general format (fixed format for small numbers, exponential format for large numbers). Trailing zeroes are suppressed. The G format results in an uppercase E for the exponent (if any), the g format in a lowercase e.

  d, i

  integer in decimal

  x

  integer in hexadecimal

  o

  integer in octal

  s

  string

  c

  character

Method Detail

atof

public static double atof(String s)

Converts a string of digits to an double

Parameters:

s - a string

Returns:

atoi

public static int atoi(String s)

Converts a string of digits (decimal, octal or hex) to an integer

Parameters:

s - a string

Returns:

the numeric value of the prefix of s representing a base 10 integer

atol

public static long atol(String s)

Converts a string of digits (decimal, octal or hex) to a long integer

Parameters:

s - a string

Returns:

the numeric value of the prefix of s representing a base 10 integer

form

public String form(char c)

Formats a character into a string (like sprintf in C)

Parameters:

c - the value to format

Returns:

the formatted string

form

public String form(double x)

Formats a double into a string (like sprintf in C)

Parameters:

x - the number to format

Returns:

the formatted string

form

public String form(long x)

Formats a long integer into a string (like sprintf in C)

Parameters:

x - the number to format

Returns:

the formatted string

form

public String form(String s)

Formats a string into a larger string (like sprintf in C)

Parameters:

s - the value to format

Returns:

the formatted string

print

public static void print(PrintStream s,
                         String fmt,
                         char x)

prints a formatted number following printf conventions

Parameters:

s - a PrintStream

fmt - the format string

x - the character to

print

public static void print(PrintStream s,
                         String fmt,
                         double x)

prints a formatted number following printf conventions

Parameters:

s - a PrintStream

fmt - the format string

x - the double to print

print

public static void print(PrintStream s,
                         String fmt,
                         long x)

prints a formatted number following printf conventions

Parameters:

s - a PrintStream

fmt - the format string

x - the long to print

print

public static void print(PrintStream s,
                         String fmt,
                         String x)

prints a formatted number following printf conventions

Parameters:

s - a PrintStream, fmt the format string

fmt -

x - a string that represents the digits to print

print

public static void print(PrintWriter s,
                         String fmt,
                         double x)

prints a formatted number following printf conventions

Parameters:

s - a PrintStream

fmt - the format string

x - the double to print

print

public static void print(PrintWriter s,
                         String fmt,
                         String x)

prints a formatted number following printf conventions

Parameters:

s - a PrintStream, fmt the format string

fmt -

x - a string that represents the digits to print