pal.io
Class FormattedOutput

java.lang.Object
  |
  +--pal.io.FormattedOutput
All Implemented Interfaces:
java.io.Serializable

public class FormattedOutput
extends java.lang.Object
implements java.io.Serializable

tools to simplify formatted output to a stream

See Also:
Serialized Form

Method Summary
 int displayDecimal(java.io.PrintWriter out, double number, int width)
          print decimal number with a prespecified number of digits after the point
 void displayInteger(java.io.PrintWriter out, int num, int maxNum)
          print integer, aligned to a reference number, (introducing space at the left side)
 void displayIntegerWhite(java.io.PrintWriter out, int maxNum)
          print whitespace of length of a string displaying a given integer
 void displayLabel(java.io.PrintWriter out, java.lang.String label, int width)
          print label with a prespecified length (label will be shortened or spaces will introduced, if necessary)
 java.lang.String getDecimalString(double number, int width)
          Returns a decimal string representation of a number with constrained width.
static FormattedOutput getInstance()
          create instance of this class (note that there is no public constructor as this class is a singleton)
 java.lang.String getSFString(double number, int sf)
          An alternative version of getSFString which works on the actual string Returns a string representing the given number to the number of significant figures requested.
 void multiplePrint(java.io.PrintWriter out, char c, int num)
          repeatedly print a character
static java.lang.String space(int size, char c)
          returns of string of a given length of a single character.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getInstance

public static FormattedOutput getInstance()
create instance of this class (note that there is no public constructor as this class is a singleton)

displayDecimal

public int displayDecimal(java.io.PrintWriter out,
                          double number,
                          int width)
print decimal number with a prespecified number of digits after the point
Parameters:
out - output stream
number - to be printed
width - number of fraction digits
Returns:
length of the string printed

getDecimalString

public java.lang.String getDecimalString(double number,
                                         int width)
Returns a decimal string representation of a number with constrained width.

getSFString

public java.lang.String getSFString(double number,
                                    int sf)
An alternative version of getSFString which works on the actual string Returns a string representing the given number to the number of significant figures requested.

displayLabel

public void displayLabel(java.io.PrintWriter out,
                         java.lang.String label,
                         int width)
print label with a prespecified length (label will be shortened or spaces will introduced, if necessary)
Parameters:
out - output stream
label - label to be printed
width - desired length

displayInteger

public void displayInteger(java.io.PrintWriter out,
                           int num,
                           int maxNum)
print integer, aligned to a reference number, (introducing space at the left side)
Parameters:
out - output stream
num - number to be printed
maxNum - reference number

displayIntegerWhite

public void displayIntegerWhite(java.io.PrintWriter out,
                                int maxNum)
print whitespace of length of a string displaying a given integer
Parameters:
output - stream
maxNum - number

multiplePrint

public void multiplePrint(java.io.PrintWriter out,
                          char c,
                          int num)
repeatedly print a character
Parameters:
out - output stream
c - character
num - number of repeats

space

public static java.lang.String space(int size,
                                     char c)
returns of string of a given length of a single character.
Parameters:
size - length of the string required
c - character