Package org.orekit.utils.formatting

Class FastDecimalFormatter

java.lang.Object

org.orekit.utils.formatting.FastDoubleFormatter

org.orekit.utils.formatting.FastDecimalFormatter

public class FastDecimalFormatter
extends FastDoubleFormatter

Formatter for double numbers with low overhead.

This class is intended to be used when formatting large amounts of data with fixed formats like, for example, large ephemeris or measurement files.

Building the formatter is done once, and the formatter FastDoubleFormatter.appendTo(Appendable, double) or FastDoubleFormatter.toString(double) methods can be called hundreds of thousands of times, without incurring the overhead that would occur with String.format(). Some tests showed this formatter is about 5 times faster than String.format() with %{width}.{%precision}f format.

Instances of this class are immutable

Since:

13.0.3

Author:

Luc Maisonobe

Constructor Summary

Constructors

Constructor	Description
FastDecimalFormatter(int width, int precision)	Simple constructor.

Method Summary

Modifier and Type	Method	Description
protected void	appendRegularValueTo(Appendable appendable, double value)	Append one formatted value to an Appendable.
int	getPrecision()	Get the precision.

Methods inherited from class org.orekit.utils.formatting.FastDoubleFormatter

appendTo, getWidth, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

FastDecimalFormatter

public FastDecimalFormatter(int width,
                            int precision)

Simple constructor.

This constructor is equivalent to Formatter float format %{width}.{precision}f

Parameters:

width - number of characters to output

precision - number of decimal precision

Method Detail

getPrecision

public int getPrecision()

Get the precision.

Returns:

precision

appendRegularValueTo

protected void appendRegularValueTo(Appendable appendable,
                                    double value)
                             throws IOException

Append one formatted value to an Appendable.

Specified by:

appendRegularValueTo in class FastDoubleFormatter

Parameters:

appendable - to append value to

value - value to format

Throws:

IOException - if an I/O error occurs