1 /****************************************************************
3 The author of this software is David M. Gay.
5 Copyright (C) 1998, 1999 by Lucent Technologies
8 Permission to use, copy, modify, and distribute this software and
9 its documentation for any purpose and without fee is hereby
10 granted, provided that the above copyright notice appear in all
11 copies and that both that the copyright notice and this
12 permission notice and warranty disclaimer appear in supporting
13 documentation, and that the name of Lucent or any of its entities
14 not be used in advertising or publicity pertaining to
15 distribution of the software without specific, written prior
18 LUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
19 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
20 IN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY
21 SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
22 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
23 IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
24 ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
27 ****************************************************************/
29 /* Please send bug reports to David M. Gay (dmg at acm dot org,
30 * with " at " changed at "@" and " dot " changed to "."). */
34 /* dtoa for IEEE arithmetic (dmg): convert double to ASCII string.
36 * Inspired by "How to Print Floating-Point Numbers Accurately" by
37 * Guy L. Steele, Jr. and Jon L. White [Proc. ACM SIGPLAN '90, pp. 112-126].
40 * 1. Rather than iterating, we use a simple numeric overestimate
41 * to determine k = floor(log10(d)). We scale relevant
42 * quantities using O(log2(k)) rather than O(k) multiplications.
43 * 2. For some modes > 2 (corresponding to ecvt and fcvt), we don't
44 * try to generate digits strictly left to right. Instead, we
45 * compute with fewer bits and propagate the carry if necessary
46 * when rounding the final digit up. This is often faster.
47 * 3. Under the assumption that input will be rounded nearest,
48 * mode 0 renders 1e23 as 1e23 rather than 9.999999999999999e22.
49 * That is, we allow equality in stopping tests when the
50 * round-nearest rule will give the same floating-point value
51 * as would satisfaction of the stopping test with strict
53 * 4. We remove common factors of powers of 2 from relevant
55 * 5. When converting floating-point integers less than 1e16,
56 * we use floating-point arithmetic rather than resorting
57 * to multiple-precision integers.
58 * 6. When asked to produce fewer than 15 digits, we first try
59 * to get by with floating-point arithmetic; we resort to
60 * multiple-precision integer arithmetic only if we cannot
61 * guarantee that the floating-point calculation has given
62 * the correctly rounded result. For k requested digits and
63 * "uniformly" distributed input, the probability is
64 * something like 10^(k-15) that we must resort to the Long
68 #ifdef Honor_FLT_ROUNDS
69 #undef Check_FLT_ROUNDS
70 #define Check_FLT_ROUNDS
72 #define Rounding Flt_Rounds
78 (d
, mode
, ndigits
, decpt
, sign
, rve
)
79 double d
; int mode
, ndigits
, *decpt
, *sign
; char **rve
;
81 (double d
, int mode
, int ndigits
, int *decpt
, int *sign
, char **rve
)
84 /* Arguments ndigits, decpt, sign are similar to those
85 of ecvt and fcvt; trailing zeros are suppressed from
86 the returned string. If not null, *rve is set to point
87 to the end of the return value. If d is +-Infinity or NaN,
88 then *decpt is set to 9999.
91 0 ==> shortest string that yields d when read in
92 and rounded to nearest.
93 1 ==> like 0, but with Steele & White stopping rule;
94 e.g. with IEEE P754 arithmetic , mode 0 gives
95 1e23 whereas mode 1 gives 9.999999999999999e22.
96 2 ==> max(1,ndigits) significant digits. This gives a
97 return value similar to that of ecvt, except
98 that trailing zeros are suppressed.
99 3 ==> through ndigits past the decimal point. This
100 gives a return value similar to that from fcvt,
101 except that trailing zeros are suppressed, and
102 ndigits can be negative.
103 4,5 ==> similar to 2 and 3, respectively, but (in
104 round-nearest mode) with the tests of mode 0 to
105 possibly return a shorter string that rounds to d.
106 With IEEE arithmetic and compilation with
107 -DHonor_FLT_ROUNDS, modes 4 and 5 behave the same
108 as modes 2 and 3 when FLT_ROUNDS != 1.
109 6-9 ==> Debugging modes similar to mode - 4: don't try
110 fast floating-point estimate (if applicable).
112 Values of mode other than 0-9 are treated as mode 0.
114 Sufficient space is allocated to the return value
115 to hold the suppressed trailing zeros.
118 int bbits
, b2
, b5
, be
, dig
, i
, ieps
, ilim
, ilim0
, ilim1
,
119 j
, j1
, k
, k0
, k_check
, leftright
, m2
, m5
, s2
, s5
,
120 spec_case
, try_quick
;
122 #ifndef Sudden_Underflow
126 Bigint
*b
, *b1
, *delta
, *mlo
, *mhi
, *S
;
130 int inexact
, oldinexact
;
132 #ifdef Honor_FLT_ROUNDS /*{*/
134 #ifdef Trust_FLT_ROUNDS /*{{ only define this if FLT_ROUNDS really works! */
135 Rounding
= Flt_Rounds
;
138 switch(fegetround()) {
139 case FE_TOWARDZERO
: Rounding
= 0; break;
140 case FE_UPWARD
: Rounding
= 2; break;
141 case FE_DOWNWARD
: Rounding
= 3;
146 #ifndef MULTIPLE_THREADS
148 freedtoa(dtoa_result
);
153 if (word0(d
) & Sign_bit
) {
154 /* set sign for everything, including 0's and NaNs */
156 word0(d
) &= ~Sign_bit
; /* clear sign bit */
161 #if defined(IEEE_Arith) + defined(VAX)
163 if ((word0(d
) & Exp_mask
) == Exp_mask
)
165 if (word0(d
) == 0x8000)
168 /* Infinity or NaN */
171 if (!word1(d
) && !(word0(d
) & 0xfffff))
172 return nrv_alloc("Infinity", rve
, 8);
174 return nrv_alloc("NaN", rve
, 3);
178 dval(d
) += 0; /* normalize */
182 return nrv_alloc("0", rve
, 1);
186 try_quick
= oldinexact
= get_inexact();
189 #ifdef Honor_FLT_ROUNDS
192 Rounding
= Rounding
== 2 ? 0 : 2;
199 b
= d2b(dval(d
), &be
, &bbits
);
200 #ifdef Sudden_Underflow
201 i
= (int)(word0(d
) >> Exp_shift1
& (Exp_mask
>>Exp_shift1
));
203 if (( i
= (int)(word0(d
) >> Exp_shift1
& (Exp_mask
>>Exp_shift1
)) )!=0) {
206 word0(d2
) &= Frac_mask1
;
209 if (( j
= 11 - hi0bits(word0(d2
) & Frac_mask
) )!=0)
213 /* log(x) ~=~ log(1.5) + (x-1.5)/1.5
214 * log10(x) = log(x) / log(10)
215 * ~=~ log(1.5)/log(10) + (x-1.5)/(1.5*log(10))
216 * log10(d) = (i-Bias)*log(2)/log(10) + log10(d2)
218 * This suggests computing an approximation k to log10(d) by
220 * k = (i - Bias)*0.301029995663981
221 * + ( (d2-1.5)*0.289529654602168 + 0.176091259055681 );
223 * We want k to be too large rather than too small.
224 * The error in the first-order Taylor series approximation
225 * is in our favor, so we just round up the constant enough
226 * to compensate for any error in the multiplication of
227 * (i - Bias) by 0.301029995663981; since |i - Bias| <= 1077,
228 * and 1077 * 0.30103 * 2^-52 ~=~ 7.2e-14,
229 * adding 1e-13 to the constant term more than suffices.
230 * Hence we adjust the constant term to 0.1760912590558.
231 * (We could get a more accurate k by invoking log10,
232 * but this is probably not worthwhile.)
240 #ifndef Sudden_Underflow
244 /* d is denormalized */
246 i
= bbits
+ be
+ (Bias
+ (P
-1) - 1);
247 x
= i
> 32 ? word0(d
) << 64 - i
| word1(d
) >> i
- 32
248 : word1(d
) << 32 - i
;
250 word0(d2
) -= 31*Exp_msk1
; /* adjust exponent */
251 i
-= (Bias
+ (P
-1) - 1) + 1;
255 ds
= (dval(d2
)-1.5)*0.289529654602168 + 0.1760912590558 + i
*0.301029995663981;
257 if (ds
< 0. && ds
!= k
)
258 k
--; /* want k = floor(ds) */
260 if (k
>= 0 && k
<= Ten_pmax
) {
261 if (dval(d
) < tens
[k
])
284 if (mode
< 0 || mode
> 9)
288 #ifdef Check_FLT_ROUNDS
289 try_quick
= Rounding
== 1;
293 #endif /*SET_INEXACT*/
313 ilim
= ilim1
= i
= ndigits
;
325 s
= s0
= rv_alloc(i
);
327 #ifdef Honor_FLT_ROUNDS
328 if (mode
> 1 && Rounding
!= 1)
332 if (ilim
>= 0 && ilim
<= Quick_max
&& try_quick
) {
334 /* Try to get by with floating-point arithmetic. */
340 ieps
= 2; /* conservative */
345 /* prevent overflows */
347 dval(d
) /= bigtens
[n_bigtens
-1];
350 for(; j
; j
>>= 1, i
++)
357 else if (( j1
= -k
)!=0) {
358 dval(d
) *= tens
[j1
& 0xf];
359 for(j
= j1
>> 4; j
; j
>>= 1, i
++)
362 dval(d
) *= bigtens
[i
];
365 if (k_check
&& dval(d
) < 1. && ilim
> 0) {
373 dval(eps
) = ieps
*dval(d
) + 7.;
374 word0(eps
) -= (P
-1)*Exp_msk1
;
378 if (dval(d
) > dval(eps
))
380 if (dval(d
) < -dval(eps
))
386 /* Use Steele & White method of only
387 * generating digits needed.
389 dval(eps
) = 0.5/tens
[ilim
-1] - dval(eps
);
394 if (dval(d
) < dval(eps
))
396 if (1. - dval(d
) < dval(eps
))
406 /* Generate ilim digits, then fix them up. */
407 dval(eps
) *= tens
[ilim
-1];
408 for(i
= 1;; i
++, dval(d
) *= 10.) {
414 if (dval(d
) > 0.5 + dval(eps
))
416 else if (dval(d
) < 0.5 - dval(eps
)) {
434 /* Do we have a "small" integer? */
436 if (be
>= 0 && k
<= Int_max
) {
439 if (ndigits
< 0 && ilim
<= 0) {
441 if (ilim
< 0 || dval(d
) <= 5*ds
)
445 for(i
= 1;; i
++, dval(d
) *= 10.) {
446 L
= (Long
)(dval(d
) / ds
);
448 #ifdef Check_FLT_ROUNDS
449 /* If FLT_ROUNDS == 2, L will usually be high by 1 */
463 #ifdef Honor_FLT_ROUNDS
467 case 2: goto bump_up
;
471 if (dval(d
) > ds
|| dval(d
) == ds
&& L
& 1) {
492 #ifndef Sudden_Underflow
493 denorm
? be
+ (Bias
+ (P
-1) - 1 + 1) :
496 1 + 4*P
- 3 - bbits
+ ((bbits
+ be
- 1) & 3);
504 if (m2
> 0 && s2
> 0) {
505 i
= m2
< s2
? m2
: s2
;
513 mhi
= pow5mult(mhi
, m5
);
518 if (( j
= b5
- m5
)!=0)
528 /* Check for special case that d is a normalized power of 2. */
531 if ((mode
< 2 || leftright
)
532 #ifdef Honor_FLT_ROUNDS
536 if (!word1(d
) && !(word0(d
) & Bndry_mask
)
537 #ifndef Sudden_Underflow
538 && word0(d
) & (Exp_mask
& ~Exp_msk1
)
541 /* The special case */
548 /* Arrange for convenient computation of quotients:
549 * shift left if necessary so divisor has 4 leading 0 bits.
551 * Perhaps we should just compute leading 28 bits of S once
552 * and for all and pass them and a shift to quorem, so it
553 * can do shifts and ors to compute the numerator for q.
556 if (( i
= ((s5
? 32 - hi0bits(S
->x
[S
->wds
-1]) : 1) + s2
) & 0x1f )!=0)
559 if (( i
= ((s5
? 32 - hi0bits(S
->x
[S
->wds
-1]) : 1) + s2
) & 0xf )!=0)
581 b
= multadd(b
, 10, 0); /* we botched the k estimate */
583 mhi
= multadd(mhi
, 10, 0);
587 if (ilim
<= 0 && (mode
== 3 || mode
== 5)) {
588 if (ilim
< 0 || cmp(b
,S
= multadd(S
,5,0)) <= 0) {
589 /* no digits, fcvt style */
601 mhi
= lshift(mhi
, m2
);
603 /* Compute mlo -- check for special case
604 * that d is a normalized power of 2.
609 mhi
= Balloc(mhi
->k
);
611 mhi
= lshift(mhi
, Log2P
);
615 dig
= quorem(b
,S
) + '0';
616 /* Do we yet have the shortest decimal string
617 * that will round to d?
620 delta
= diff(S
, mhi
);
621 j1
= delta
->sign
? 1 : cmp(b
, delta
);
624 if (j1
== 0 && mode
!= 1 && !(word1(d
) & 1)
625 #ifdef Honor_FLT_ROUNDS
634 else if (!b
->x
[0] && b
->wds
<= 1)
641 if (j
< 0 || j
== 0 && mode
!= 1
646 if (!b
->x
[0] && b
->wds
<= 1) {
652 #ifdef Honor_FLT_ROUNDS
655 case 0: goto accept_dig
;
656 case 2: goto keep_dig
;
658 #endif /*Honor_FLT_ROUNDS*/
662 if ((j1
> 0 || j1
== 0 && dig
& 1)
671 #ifdef Honor_FLT_ROUNDS
675 if (dig
== '9') { /* possible if i == 1 */
683 #ifdef Honor_FLT_ROUNDS
689 b
= multadd(b
, 10, 0);
691 mlo
= mhi
= multadd(mhi
, 10, 0);
693 mlo
= multadd(mlo
, 10, 0);
694 mhi
= multadd(mhi
, 10, 0);
700 *s
++ = dig
= quorem(b
,S
) + '0';
701 if (!b
->x
[0] && b
->wds
<= 1) {
709 b
= multadd(b
, 10, 0);
712 /* Round off last digit */
714 #ifdef Honor_FLT_ROUNDS
716 case 0: goto trimzeros
;
717 case 2: goto roundoff
;
722 if (j
> 0 || j
== 0 && dig
& 1) {
740 if (mlo
&& mlo
!= mhi
)
748 word0(d
) = Exp_1
+ (70 << Exp_shift
);
753 else if (!oldinexact
)