Jackson 2.18.2 · com.fasterxml.jackson.core.io.schubfach.FloatToDecimal

Field Summary

Modifier and Type	Field and Description
private static final int	BQ_MASK
private final byte[]	bytes
private static final int	C_MIN
pack-priv static final int	C_TINY
pack-priv static final int	E_MAX
pack-priv static final int	E_MIN
pack-priv static final int	H
private int	index
pack-priv static final int	K_MAX
pack-priv static final int	K_MIN
private static final int	MASK_28
private static final long	MASK_32
public final int	MAX_CHARS
private static final int	MINUS_INF
private static final int	MINUS_ZERO
private static final int	NAN
private static final int	NON_SPECIAL
pack-priv static final int	P
private static final int	PLUS_INF
private static final int	PLUS_ZERO
pack-priv static final int	Q_MAX
pack-priv static final int	Q_MIN
private static final int	T_MASK
private static final int	W

Constructor Summary

Access	Constructor and Description
private	FloatToDecimal()

Method Summary

Modifier and Type	Method and Description
private void	append(int c)
private void	append8Digits(int m)
private void	appendDigit(int d)
private String	charsToString()
private void	exponent(int e)
private void	removeTrailingZeroes()
private static int	rop(long g, long cp)
private int	toChars(int f, int e)
private int	toChars1(int h, int l, int e)
private int	toChars2(int h, int l, int e)
private int	toChars3(int h, int l, int e)
private int	toDecimal(float v)
private int	toDecimal(int q, int c, int dk)
private String	toDecimalString(float v)
public static String	Returns: a string rendering of the argument. toString(float the `float` to be rendered. v) Returns a string rendering of the `float` argument.
private int	y(int a)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

BQ_MASK	back to summary
private static final int BQ_MASK

bytes	back to summary
private final byte[] bytes

C_MIN	back to summary
private static final int C_MIN

C_TINY	back to summary
pack-priv static final int C_TINY

E_MAX	back to summary
pack-priv static final int E_MAX

E_MIN	back to summary
pack-priv static final int E_MIN

H	back to summary
pack-priv static final int H

index	back to summary
private int index

K_MAX	back to summary
pack-priv static final int K_MAX

K_MIN	back to summary
pack-priv static final int K_MIN

MASK_28	back to summary
private static final int MASK_28

MASK_32	back to summary
private static final long MASK_32

MAX_CHARS	back to summary
public final int MAX_CHARS

MINUS_INF	back to summary
private static final int MINUS_INF

MINUS_ZERO	back to summary
private static final int MINUS_ZERO

NAN	back to summary
private static final int NAN

NON_SPECIAL	back to summary
private static final int NON_SPECIAL

P	back to summary
pack-priv static final int P

PLUS_INF	back to summary
private static final int PLUS_INF

PLUS_ZERO	back to summary
private static final int PLUS_ZERO

Q_MAX	back to summary
pack-priv static final int Q_MAX

Q_MIN	back to summary
pack-priv static final int Q_MIN

T_MASK	back to summary
private static final int T_MASK

W	back to summary
private static final int W

Constructor Detail

FloatToDecimal	back to summary
private FloatToDecimal()

Method Detail

append	back to summary
private void append(int c)

append8Digits	back to summary
private void append8Digits(int m)

appendDigit	back to summary
private void appendDigit(int d)

charsToString	back to summary
private String charsToString() Annotations @SuppressWarnings:deprecation

exponent	back to summary
private void exponent(int e)

removeTrailingZeroes	back to summary
private void removeTrailingZeroes()

rop	back to summary
private static int rop(long g, long cp)

toChars	back to summary
private int toChars(int f, int e)

toChars1	back to summary
private int toChars1(int h, int l, int e)

toChars2	back to summary
private int toChars2(int h, int l, int e)

toChars3	back to summary
private int toChars3(int h, int l, int e)

toDecimal	back to summary
private int toDecimal(float v)

toDecimal	back to summary
private int toDecimal(int q, int c, int dk)

toDecimalString	back to summary
private String toDecimalString(float v)

toString back to summary

toString	back to summary
public static String toString(float v) Returns a string rendering of the `float` argument. The characters of the result are all drawn from the ASCII set. Any NaN, whether quiet or signaling, is rendered as `"NaN"`, regardless of the sign bit. The infinities +∞ and -∞ are rendered as `"Infinity"` and `"-Infinity"`, respectively. The positive and negative zeroes are rendered as `"0.0"` and `"-0.0"`, respectively. A finite negative `v` is rendered as the sign '`-`' followed by the rendering of the magnitude -`v`. A finite positive `v` is rendered in two stages: Selection of a decimal: A well-defined decimal d_v is selected to represent `v`. Formatting as a string: The decimal d_v is formatted as a string, either in plain or in computerized scientific notation, depending on its value. A decimal is a number of the form d×10ⁱ for some (unique) integers d > 0 and i such that d is not a multiple of 10. These integers are the significand and the exponent, respectively, of the decimal. The length of the decimal is the (unique) integer n meeting 10^n-1 ≤ d < 10ⁿ. The decimal d_v for a finite positive `v` is defined as follows: Let R be the set of all decimals that round to `v` according to the usual round-to-closest rule of IEEE 754 floating-point arithmetic. Let m be the minimal length over all decimals in R. When m ≥ 2, let T be the set of all decimals in R with length m. Otherwise, let T be the set of all decimals in R with length 1 or 2. Define d_v as the decimal in T that is closest to `v`. Or if there are two such decimals in T, select the one with the even significand (there is exactly one). The (uniquely) selected decimal d_v is then formatted. Let d, i and n be the significand, exponent and length of d_v, respectively. Further, let e = n + i - 1 and let d₁…d_n be the usual decimal expansion of the significand. Note that d₁ ≠ 0 ≠ d_n. Case -3 ≤ e < 0: d_v is formatted as `0.0`…`0`d₁…d_n, where there are exactly -(n + i) zeroes between the decimal point and d₁. For example, 123 × 10^-4 is formatted as `0.0123`. Case 0 ≤ e < 7: Subcase i ≥ 0: d_v is formatted as d₁…d_n`0`…`0.0`, where there are exactly i zeroes between d_n and the decimal point. For example, 123 × 10² is formatted as `12300.0`. Subcase i < 0: d_v is formatted as d₁…d_n+i.d_n+i+1…d_n. There are exactly -i digits to the right of the decimal point. For example, 123 × 10^-1 is formatted as `12.3`. Case e < -3 or e ≥ 7: computerized scientific notation is used to format d_v. Here e is formatted as by `Integer#toString(int)`. Subcase n = 1: d_v is formatted as d₁`.0E`e. For example, 1 × 10²³ is formatted as `1.0E23`. Subcase n > 1: d_v is formatted as d₁`.`d₂…d_n`E`e. For example, 123 × 10^-21 is formatted as `1.23E-19`. Parameters v:float the `float` to be rendered. Returns:String a string rendering of the argument.

public static String toString(float v)

Returns a string rendering of the float argument.

The characters of the result are all drawn from the ASCII set.

Any NaN, whether quiet or signaling, is rendered as "NaN", regardless of the sign bit.
The infinities +∞ and -∞ are rendered as "Infinity" and "-Infinity", respectively.
The positive and negative zeroes are rendered as "0.0" and "-0.0", respectively.
A finite negative v is rendered as the sign '-' followed by the rendering of the magnitude -v.
A finite positive v is rendered in two stages:
- Selection of a decimal: A well-defined decimal d_v is selected to represent v.
- Formatting as a string: The decimal d_v is formatted as a string, either in plain or in computerized scientific notation, depending on its value.

A decimal is a number of the form d×10ⁱ for some (unique) integers d > 0 and i such that d is not a multiple of 10. These integers are the significand and the exponent, respectively, of the decimal. The length of the decimal is the (unique) integer n meeting 10^n-1 ≤ d < 10ⁿ.

The decimal d_v for a finite positive v is defined as follows:

Let R be the set of all decimals that round to v according to the usual round-to-closest rule of IEEE 754 floating-point arithmetic.
Let m be the minimal length over all decimals in R.
When m ≥ 2, let T be the set of all decimals in R with length m. Otherwise, let T be the set of all decimals in R with length 1 or 2.
Define d_v as the decimal in T that is closest to v. Or if there are two such decimals in T, select the one with the even significand (there is exactly one).

The (uniquely) selected decimal d_v is then formatted.

Let d, i and n be the significand, exponent and length of d_v, respectively. Further, let e = n + i - 1 and let d₁…d_n be the usual decimal expansion of the significand. Note that d₁ ≠ 0 ≠ d_n.

Case -3 ≤ e < 0: d_v is formatted as 0.0…0d₁…d_n, where there are exactly -(n + i) zeroes between the decimal point and d₁. For example, 123 × 10^-4 is formatted as 0.0123.
Case 0 ≤ e < 7:
- Subcase i ≥ 0: d_v is formatted as d₁…d_n0…0.0, where there are exactly i zeroes between d_n and the decimal point. For example, 123 × 10² is formatted as 12300.0.
- Subcase i < 0: d_v is formatted as d₁…d_n+i.d_n+i+1…d_n. There are exactly -i digits to the right of the decimal point. For example, 123 × 10^-1 is formatted as 12.3.
Case e < -3 or e ≥ 7: computerized scientific notation is used to format d_v. Here e is formatted as by Integer#toString(int).
- Subcase n = 1: d_v is formatted as d₁.0Ee. For example, 1 × 10²³ is formatted as 1.0E23.
- Subcase n > 1: d_v is formatted as d₁.d₂…d_nEe. For example, 123 × 10^-21 is formatted as 1.23E-19.

Parameters

v:float: the float to be rendered.

Returns:String

a string rendering of the argument.