xal.tools.text

Class DoubleToString

java.lang.Object

xal.tools.text.DoubleToString

public class DoubleToString
extends java.lang.Object

This algorithm for appending doubles to StringBuffer is borrowed from "Java Performance Tuning" by Jack Shirazi. He explains how the JDK implementation is "hideously under-optimized". This implementation is considerably more efficient both in terms of speed and memory usage.

Field Summary

Fields

Modifier and Type	Field and Description
static char[]	DOT_ZERO
static char[]	DOUBLE_ZERO
static char[]	DOUBLE_ZERO0
static char[]	DOUBLE_ZERO2
static char[]	INFINITY Character array representing number infinity
static char[]	NaN Character array representing Not-A-Number
static char[]	NEGATIVE_INFINITY
static char[]	POSITIVE_INFINITY
static char[][]	ZEROS Ordered vectors of zeros

Constructor Summary

Constructors

Constructor and Description
DoubleToString()

Method Summary

Modifier and Type	Method and Description
static void	append(java.lang.StringBuffer s, double d) I think this is one of the two main methods in this class.
static void	append(java.lang.StringBuffer s, int i) I think this is one of the two main methods in this class.
static void	appendAsDouble(java.lang.StringBuffer s, long l, long l_mag, int d_magnitude, int numFractDigits, char decimalPoint, char thousandsSeparator, int numDigitsSeparated, char negativePrefix, char negativeSuffix) One again, I'm not sure how to use this method, Craig was the original author.
static void	appendFormatted(java.lang.StringBuffer s, double d, int numFractDigits, char decimalPoint, char thousandsSeparator, int numDigitsSeparated, char negativePrefix, char negativeSuffix) I'm not sure how this works or what it does since Craig originally build this class.
static long	getNthDigit(long l, int n)
static void	main(java.lang.String[] args)
static void	main1(java.lang.String[] args)

Methods inherited from class java.lang.Object

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

Field Detail

INFINITY

public static final char[] INFINITY

Character array representing number infinity

NaN

public static final char[] NaN

Character array representing Not-A-Number

ZEROS

public static final char[][] ZEROS

Ordered vectors of zeros

NEGATIVE_INFINITY

public static final char[] NEGATIVE_INFINITY

POSITIVE_INFINITY

public static final char[] POSITIVE_INFINITY

DOUBLE_ZERO

public static final char[] DOUBLE_ZERO

DOUBLE_ZERO2

public static final char[] DOUBLE_ZERO2

DOUBLE_ZERO0

public static final char[] DOUBLE_ZERO0

DOT_ZERO

public static final char[] DOT_ZERO

Constructor Detail

DoubleToString

public DoubleToString()

Method Detail

appendFormatted

public static void appendFormatted(java.lang.StringBuffer s,
                                   double d,
                                   int numFractDigits,
                                   char decimalPoint,
                                   char thousandsSeparator,
                                   int numDigitsSeparated,
                                   char negativePrefix,
                                   char negativeSuffix)

I'm not sure how this works or what it does since Craig originally build this class. There's not much documentation.

Parameters:

s -

d -

numFractDigits -

decimalPoint -

thousandsSeparator -

numDigitsSeparated -

negativePrefix -

negativeSuffix -

Since:

Apr 19, 2011

appendAsDouble

public static void appendAsDouble(java.lang.StringBuffer s,
                                  long l,
                                  long l_mag,
                                  int d_magnitude,
                                  int numFractDigits,
                                  char decimalPoint,
                                  char thousandsSeparator,
                                  int numDigitsSeparated,
                                  char negativePrefix,
                                  char negativeSuffix)

One again, I'm not sure how to use this method, Craig was the original author.

Parameters:

s -

l -

l_mag -

d_magnitude -

numFractDigits -

decimalPoint -

thousandsSeparator -

numDigitsSeparated -

negativePrefix -

negativeSuffix -

Since:

Apr 19, 2011

getNthDigit

public static long getNthDigit(long l,
                               int n)

main

public static void main(java.lang.String[] args)

main1

public static void main1(java.lang.String[] args)

append

public static void append(java.lang.StringBuffer s,
                          double d)

I think this is one of the two main methods in this class. It appends a double number to a StringBuffer object using optimized float-to-character representation algorithms.

Parameters:

s - string buffer

d - a double-valued number being appended to the string

Since:

Apr 19, 2011

append

public static void append(java.lang.StringBuffer s,
                          int i)

I think this is one of the two main methods in this class. It appends an integer number to a StringBuffer object using optimized float-to-character representation algorithms.

Parameters:

s - string buffer

i - a double-valued number being appended to the string

Since:

Apr 19, 2011