Mention that freeware gdbm might be obsolete.
[perl.git] / numeric.c
1 /*    numeric.c
2  *
3  *    Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
4  *    2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  */
10
11 /*
12  * "That only makes eleven (plus one mislaid) and not fourteen,
13  *  unless wizards count differently to other people."  --Beorn
14  *
15  *     [p.115 of _The Hobbit_: "Queer Lodgings"]
16  */
17
18 /*
19 =head1 Numeric functions
20
21 =cut
22
23 This file contains all the stuff needed by perl for manipulating numeric
24 values, including such things as replacements for the OS's atof() function
25
26 */
27
28 #include "EXTERN.h"
29 #define PERL_IN_NUMERIC_C
30 #include "perl.h"
31
32 U32
33 Perl_cast_ulong(NV f)
34 {
35   if (f < 0.0)
36     return f < I32_MIN ? (U32) I32_MIN : (U32)(I32) f;
37   if (f < U32_MAX_P1) {
38 #if CASTFLAGS & 2
39     if (f < U32_MAX_P1_HALF)
40       return (U32) f;
41     f -= U32_MAX_P1_HALF;
42     return ((U32) f) | (1 + U32_MAX >> 1);
43 #else
44     return (U32) f;
45 #endif
46   }
47   return f > 0 ? U32_MAX : 0 /* NaN */;
48 }
49
50 I32
51 Perl_cast_i32(NV f)
52 {
53   if (f < I32_MAX_P1)
54     return f < I32_MIN ? I32_MIN : (I32) f;
55   if (f < U32_MAX_P1) {
56 #if CASTFLAGS & 2
57     if (f < U32_MAX_P1_HALF)
58       return (I32)(U32) f;
59     f -= U32_MAX_P1_HALF;
60     return (I32)(((U32) f) | (1 + U32_MAX >> 1));
61 #else
62     return (I32)(U32) f;
63 #endif
64   }
65   return f > 0 ? (I32)U32_MAX : 0 /* NaN */;
66 }
67
68 IV
69 Perl_cast_iv(NV f)
70 {
71   if (f < IV_MAX_P1)
72     return f < IV_MIN ? IV_MIN : (IV) f;
73   if (f < UV_MAX_P1) {
74 #if CASTFLAGS & 2
75     /* For future flexibility allowing for sizeof(UV) >= sizeof(IV)  */
76     if (f < UV_MAX_P1_HALF)
77       return (IV)(UV) f;
78     f -= UV_MAX_P1_HALF;
79     return (IV)(((UV) f) | (1 + UV_MAX >> 1));
80 #else
81     return (IV)(UV) f;
82 #endif
83   }
84   return f > 0 ? (IV)UV_MAX : 0 /* NaN */;
85 }
86
87 UV
88 Perl_cast_uv(NV f)
89 {
90   if (f < 0.0)
91     return f < IV_MIN ? (UV) IV_MIN : (UV)(IV) f;
92   if (f < UV_MAX_P1) {
93 #if CASTFLAGS & 2
94     if (f < UV_MAX_P1_HALF)
95       return (UV) f;
96     f -= UV_MAX_P1_HALF;
97     return ((UV) f) | (1 + UV_MAX >> 1);
98 #else
99     return (UV) f;
100 #endif
101   }
102   return f > 0 ? UV_MAX : 0 /* NaN */;
103 }
104
105 /*
106 =for apidoc grok_bin
107
108 converts a string representing a binary number to numeric form.
109
110 On entry I<start> and I<*len> give the string to scan, I<*flags> gives
111 conversion flags, and I<result> should be NULL or a pointer to an NV.
112 The scan stops at the end of the string, or the first invalid character.
113 Unless C<PERL_SCAN_SILENT_ILLDIGIT> is set in I<*flags>, encountering an
114 invalid character will also trigger a warning.
115 On return I<*len> is set to the length of the scanned string,
116 and I<*flags> gives output flags.
117
118 If the value is <= C<UV_MAX> it is returned as a UV, the output flags are clear,
119 and nothing is written to I<*result>.  If the value is > UV_MAX C<grok_bin>
120 returns UV_MAX, sets C<PERL_SCAN_GREATER_THAN_UV_MAX> in the output flags,
121 and writes the value to I<*result> (or the value is discarded if I<result>
122 is NULL).
123
124 The binary number may optionally be prefixed with "0b" or "b" unless
125 C<PERL_SCAN_DISALLOW_PREFIX> is set in I<*flags> on entry.  If
126 C<PERL_SCAN_ALLOW_UNDERSCORES> is set in I<*flags> then the binary
127 number may use '_' characters to separate digits.
128
129 =cut
130
131 Not documented yet because experimental is C<PERL_SCAN_SILENT_NON_PORTABLE
132 which suppresses any message for non-portable numbers that are still valid
133 on this platform.
134  */
135
136 UV
137 Perl_grok_bin(pTHX_ const char *start, STRLEN *len_p, I32 *flags, NV *result)
138 {
139     const char *s = start;
140     STRLEN len = *len_p;
141     UV value = 0;
142     NV value_nv = 0;
143
144     const UV max_div_2 = UV_MAX / 2;
145     const bool allow_underscores = cBOOL(*flags & PERL_SCAN_ALLOW_UNDERSCORES);
146     bool overflowed = FALSE;
147     char bit;
148
149     PERL_ARGS_ASSERT_GROK_BIN;
150
151     if (!(*flags & PERL_SCAN_DISALLOW_PREFIX)) {
152         /* strip off leading b or 0b.
153            for compatibility silently suffer "b" and "0b" as valid binary
154            numbers. */
155         if (len >= 1) {
156             if (isALPHA_FOLD_EQ(s[0], 'b')) {
157                 s++;
158                 len--;
159             }
160             else if (len >= 2 && s[0] == '0' && (isALPHA_FOLD_EQ(s[1], 'b'))) {
161                 s+=2;
162                 len-=2;
163             }
164         }
165     }
166
167     for (; len-- && (bit = *s); s++) {
168         if (bit == '0' || bit == '1') {
169             /* Write it in this wonky order with a goto to attempt to get the
170                compiler to make the common case integer-only loop pretty tight.
171                With gcc seems to be much straighter code than old scan_bin.  */
172           redo:
173             if (!overflowed) {
174                 if (value <= max_div_2) {
175                     value = (value << 1) | (bit - '0');
176                     continue;
177                 }
178                 /* Bah. We're just overflowed.  */
179                 /* diag_listed_as: Integer overflow in %s number */
180                 Perl_ck_warner_d(aTHX_ packWARN(WARN_OVERFLOW),
181                                  "Integer overflow in binary number");
182                 overflowed = TRUE;
183                 value_nv = (NV) value;
184             }
185             value_nv *= 2.0;
186             /* If an NV has not enough bits in its mantissa to
187              * represent a UV this summing of small low-order numbers
188              * is a waste of time (because the NV cannot preserve
189              * the low-order bits anyway): we could just remember when
190              * did we overflow and in the end just multiply value_nv by the
191              * right amount. */
192             value_nv += (NV)(bit - '0');
193             continue;
194         }
195         if (bit == '_' && len && allow_underscores && (bit = s[1])
196             && (bit == '0' || bit == '1'))
197             {
198                 --len;
199                 ++s;
200                 goto redo;
201             }
202         if (!(*flags & PERL_SCAN_SILENT_ILLDIGIT))
203             Perl_ck_warner(aTHX_ packWARN(WARN_DIGIT),
204                            "Illegal binary digit '%c' ignored", *s);
205         break;
206     }
207     
208     if (   ( overflowed && value_nv > 4294967295.0)
209 #if UVSIZE > 4
210         || (!overflowed && value > 0xffffffff
211             && ! (*flags & PERL_SCAN_SILENT_NON_PORTABLE))
212 #endif
213         ) {
214         Perl_ck_warner(aTHX_ packWARN(WARN_PORTABLE),
215                        "Binary number > 0b11111111111111111111111111111111 non-portable");
216     }
217     *len_p = s - start;
218     if (!overflowed) {
219         *flags = 0;
220         return value;
221     }
222     *flags = PERL_SCAN_GREATER_THAN_UV_MAX;
223     if (result)
224         *result = value_nv;
225     return UV_MAX;
226 }
227
228 /*
229 =for apidoc grok_hex
230
231 converts a string representing a hex number to numeric form.
232
233 On entry I<start> and I<*len_p> give the string to scan, I<*flags> gives
234 conversion flags, and I<result> should be NULL or a pointer to an NV.
235 The scan stops at the end of the string, or the first invalid character.
236 Unless C<PERL_SCAN_SILENT_ILLDIGIT> is set in I<*flags>, encountering an
237 invalid character will also trigger a warning.
238 On return I<*len> is set to the length of the scanned string,
239 and I<*flags> gives output flags.
240
241 If the value is <= UV_MAX it is returned as a UV, the output flags are clear,
242 and nothing is written to I<*result>.  If the value is > UV_MAX C<grok_hex>
243 returns UV_MAX, sets C<PERL_SCAN_GREATER_THAN_UV_MAX> in the output flags,
244 and writes the value to I<*result> (or the value is discarded if I<result>
245 is NULL).
246
247 The hex number may optionally be prefixed with "0x" or "x" unless
248 C<PERL_SCAN_DISALLOW_PREFIX> is set in I<*flags> on entry.  If
249 C<PERL_SCAN_ALLOW_UNDERSCORES> is set in I<*flags> then the hex
250 number may use '_' characters to separate digits.
251
252 =cut
253
254 Not documented yet because experimental is C<PERL_SCAN_SILENT_NON_PORTABLE
255 which suppresses any message for non-portable numbers, but which are valid
256 on this platform.
257  */
258
259 UV
260 Perl_grok_hex(pTHX_ const char *start, STRLEN *len_p, I32 *flags, NV *result)
261 {
262     const char *s = start;
263     STRLEN len = *len_p;
264     UV value = 0;
265     NV value_nv = 0;
266     const UV max_div_16 = UV_MAX / 16;
267     const bool allow_underscores = cBOOL(*flags & PERL_SCAN_ALLOW_UNDERSCORES);
268     bool overflowed = FALSE;
269
270     PERL_ARGS_ASSERT_GROK_HEX;
271
272     if (!(*flags & PERL_SCAN_DISALLOW_PREFIX)) {
273         /* strip off leading x or 0x.
274            for compatibility silently suffer "x" and "0x" as valid hex numbers.
275         */
276         if (len >= 1) {
277             if (isALPHA_FOLD_EQ(s[0], 'x')) {
278                 s++;
279                 len--;
280             }
281             else if (len >= 2 && s[0] == '0' && (isALPHA_FOLD_EQ(s[1], 'x'))) {
282                 s+=2;
283                 len-=2;
284             }
285         }
286     }
287
288     for (; len-- && *s; s++) {
289         if (isXDIGIT(*s)) {
290             /* Write it in this wonky order with a goto to attempt to get the
291                compiler to make the common case integer-only loop pretty tight.
292                With gcc seems to be much straighter code than old scan_hex.  */
293           redo:
294             if (!overflowed) {
295                 if (value <= max_div_16) {
296                     value = (value << 4) | XDIGIT_VALUE(*s);
297                     continue;
298                 }
299                 /* Bah. We're just overflowed.  */
300                 /* diag_listed_as: Integer overflow in %s number */
301                 Perl_ck_warner_d(aTHX_ packWARN(WARN_OVERFLOW),
302                                  "Integer overflow in hexadecimal number");
303                 overflowed = TRUE;
304                 value_nv = (NV) value;
305             }
306             value_nv *= 16.0;
307             /* If an NV has not enough bits in its mantissa to
308              * represent a UV this summing of small low-order numbers
309              * is a waste of time (because the NV cannot preserve
310              * the low-order bits anyway): we could just remember when
311              * did we overflow and in the end just multiply value_nv by the
312              * right amount of 16-tuples. */
313             value_nv += (NV) XDIGIT_VALUE(*s);
314             continue;
315         }
316         if (*s == '_' && len && allow_underscores && s[1]
317                 && isXDIGIT(s[1]))
318             {
319                 --len;
320                 ++s;
321                 goto redo;
322             }
323         if (!(*flags & PERL_SCAN_SILENT_ILLDIGIT))
324             Perl_ck_warner(aTHX_ packWARN(WARN_DIGIT),
325                         "Illegal hexadecimal digit '%c' ignored", *s);
326         break;
327     }
328     
329     if (   ( overflowed && value_nv > 4294967295.0)
330 #if UVSIZE > 4
331         || (!overflowed && value > 0xffffffff
332             && ! (*flags & PERL_SCAN_SILENT_NON_PORTABLE))
333 #endif
334         ) {
335         Perl_ck_warner(aTHX_ packWARN(WARN_PORTABLE),
336                        "Hexadecimal number > 0xffffffff non-portable");
337     }
338     *len_p = s - start;
339     if (!overflowed) {
340         *flags = 0;
341         return value;
342     }
343     *flags = PERL_SCAN_GREATER_THAN_UV_MAX;
344     if (result)
345         *result = value_nv;
346     return UV_MAX;
347 }
348
349 /*
350 =for apidoc grok_oct
351
352 converts a string representing an octal number to numeric form.
353
354 On entry I<start> and I<*len> give the string to scan, I<*flags> gives
355 conversion flags, and I<result> should be NULL or a pointer to an NV.
356 The scan stops at the end of the string, or the first invalid character.
357 Unless C<PERL_SCAN_SILENT_ILLDIGIT> is set in I<*flags>, encountering an
358 8 or 9 will also trigger a warning.
359 On return I<*len> is set to the length of the scanned string,
360 and I<*flags> gives output flags.
361
362 If the value is <= UV_MAX it is returned as a UV, the output flags are clear,
363 and nothing is written to I<*result>.  If the value is > UV_MAX C<grok_oct>
364 returns UV_MAX, sets C<PERL_SCAN_GREATER_THAN_UV_MAX> in the output flags,
365 and writes the value to I<*result> (or the value is discarded if I<result>
366 is NULL).
367
368 If C<PERL_SCAN_ALLOW_UNDERSCORES> is set in I<*flags> then the octal
369 number may use '_' characters to separate digits.
370
371 =cut
372
373 Not documented yet because experimental is C<PERL_SCAN_SILENT_NON_PORTABLE>
374 which suppresses any message for non-portable numbers, but which are valid
375 on this platform.
376  */
377
378 UV
379 Perl_grok_oct(pTHX_ const char *start, STRLEN *len_p, I32 *flags, NV *result)
380 {
381     const char *s = start;
382     STRLEN len = *len_p;
383     UV value = 0;
384     NV value_nv = 0;
385     const UV max_div_8 = UV_MAX / 8;
386     const bool allow_underscores = cBOOL(*flags & PERL_SCAN_ALLOW_UNDERSCORES);
387     bool overflowed = FALSE;
388
389     PERL_ARGS_ASSERT_GROK_OCT;
390
391     for (; len-- && *s; s++) {
392         if (isOCTAL(*s)) {
393             /* Write it in this wonky order with a goto to attempt to get the
394                compiler to make the common case integer-only loop pretty tight.
395             */
396           redo:
397             if (!overflowed) {
398                 if (value <= max_div_8) {
399                     value = (value << 3) | OCTAL_VALUE(*s);
400                     continue;
401                 }
402                 /* Bah. We're just overflowed.  */
403                 /* diag_listed_as: Integer overflow in %s number */
404                 Perl_ck_warner_d(aTHX_ packWARN(WARN_OVERFLOW),
405                                "Integer overflow in octal number");
406                 overflowed = TRUE;
407                 value_nv = (NV) value;
408             }
409             value_nv *= 8.0;
410             /* If an NV has not enough bits in its mantissa to
411              * represent a UV this summing of small low-order numbers
412              * is a waste of time (because the NV cannot preserve
413              * the low-order bits anyway): we could just remember when
414              * did we overflow and in the end just multiply value_nv by the
415              * right amount of 8-tuples. */
416             value_nv += (NV) OCTAL_VALUE(*s);
417             continue;
418         }
419         if (*s == '_' && len && allow_underscores && isOCTAL(s[1])) {
420             --len;
421             ++s;
422             goto redo;
423         }
424         /* Allow \octal to work the DWIM way (that is, stop scanning
425          * as soon as non-octal characters are seen, complain only if
426          * someone seems to want to use the digits eight and nine.  Since we
427          * know it is not octal, then if isDIGIT, must be an 8 or 9). */
428         if (isDIGIT(*s)) {
429             if (!(*flags & PERL_SCAN_SILENT_ILLDIGIT))
430                 Perl_ck_warner(aTHX_ packWARN(WARN_DIGIT),
431                                "Illegal octal digit '%c' ignored", *s);
432         }
433         break;
434     }
435     
436     if (   ( overflowed && value_nv > 4294967295.0)
437 #if UVSIZE > 4
438         || (!overflowed && value > 0xffffffff
439             && ! (*flags & PERL_SCAN_SILENT_NON_PORTABLE))
440 #endif
441         ) {
442         Perl_ck_warner(aTHX_ packWARN(WARN_PORTABLE),
443                        "Octal number > 037777777777 non-portable");
444     }
445     *len_p = s - start;
446     if (!overflowed) {
447         *flags = 0;
448         return value;
449     }
450     *flags = PERL_SCAN_GREATER_THAN_UV_MAX;
451     if (result)
452         *result = value_nv;
453     return UV_MAX;
454 }
455
456 /*
457 =for apidoc scan_bin
458
459 For backwards compatibility.  Use C<grok_bin> instead.
460
461 =for apidoc scan_hex
462
463 For backwards compatibility.  Use C<grok_hex> instead.
464
465 =for apidoc scan_oct
466
467 For backwards compatibility.  Use C<grok_oct> instead.
468
469 =cut
470  */
471
472 NV
473 Perl_scan_bin(pTHX_ const char *start, STRLEN len, STRLEN *retlen)
474 {
475     NV rnv;
476     I32 flags = *retlen ? PERL_SCAN_ALLOW_UNDERSCORES : 0;
477     const UV ruv = grok_bin (start, &len, &flags, &rnv);
478
479     PERL_ARGS_ASSERT_SCAN_BIN;
480
481     *retlen = len;
482     return (flags & PERL_SCAN_GREATER_THAN_UV_MAX) ? rnv : (NV)ruv;
483 }
484
485 NV
486 Perl_scan_oct(pTHX_ const char *start, STRLEN len, STRLEN *retlen)
487 {
488     NV rnv;
489     I32 flags = *retlen ? PERL_SCAN_ALLOW_UNDERSCORES : 0;
490     const UV ruv = grok_oct (start, &len, &flags, &rnv);
491
492     PERL_ARGS_ASSERT_SCAN_OCT;
493
494     *retlen = len;
495     return (flags & PERL_SCAN_GREATER_THAN_UV_MAX) ? rnv : (NV)ruv;
496 }
497
498 NV
499 Perl_scan_hex(pTHX_ const char *start, STRLEN len, STRLEN *retlen)
500 {
501     NV rnv;
502     I32 flags = *retlen ? PERL_SCAN_ALLOW_UNDERSCORES : 0;
503     const UV ruv = grok_hex (start, &len, &flags, &rnv);
504
505     PERL_ARGS_ASSERT_SCAN_HEX;
506
507     *retlen = len;
508     return (flags & PERL_SCAN_GREATER_THAN_UV_MAX) ? rnv : (NV)ruv;
509 }
510
511 /*
512 =for apidoc grok_numeric_radix
513
514 Scan and skip for a numeric decimal separator (radix).
515
516 =cut
517  */
518 bool
519 Perl_grok_numeric_radix(pTHX_ const char **sp, const char *send)
520 {
521 #ifdef USE_LOCALE_NUMERIC
522     PERL_ARGS_ASSERT_GROK_NUMERIC_RADIX;
523
524     if (IN_LC(LC_NUMERIC)) {
525         DECLARE_STORE_LC_NUMERIC_SET_TO_NEEDED();
526         if (PL_numeric_radix_sv) {
527             STRLEN len;
528             const char * const radix = SvPV(PL_numeric_radix_sv, len);
529             if (*sp + len <= send && memEQ(*sp, radix, len)) {
530                 *sp += len;
531                 RESTORE_LC_NUMERIC();
532                 return TRUE;
533             }
534         }
535         RESTORE_LC_NUMERIC();
536     }
537     /* always try "." if numeric radix didn't match because
538      * we may have data from different locales mixed */
539 #endif
540
541     PERL_ARGS_ASSERT_GROK_NUMERIC_RADIX;
542
543     if (*sp < send && **sp == '.') {
544         ++*sp;
545         return TRUE;
546     }
547     return FALSE;
548 }
549
550 /*
551 =for apidoc grok_number_flags
552
553 Recognise (or not) a number.  The type of the number is returned
554 (0 if unrecognised), otherwise it is a bit-ORed combination of
555 IS_NUMBER_IN_UV, IS_NUMBER_GREATER_THAN_UV_MAX, IS_NUMBER_NOT_INT,
556 IS_NUMBER_NEG, IS_NUMBER_INFINITY, IS_NUMBER_NAN (defined in perl.h).
557
558 If the value of the number can fit in a UV, it is returned in the *valuep
559 IS_NUMBER_IN_UV will be set to indicate that *valuep is valid, IS_NUMBER_IN_UV
560 will never be set unless *valuep is valid, but *valuep may have been assigned
561 to during processing even though IS_NUMBER_IN_UV is not set on return.
562 If valuep is NULL, IS_NUMBER_IN_UV will be set for the same cases as when
563 valuep is non-NULL, but no actual assignment (or SEGV) will occur.
564
565 IS_NUMBER_NOT_INT will be set with IS_NUMBER_IN_UV if trailing decimals were
566 seen (in which case *valuep gives the true value truncated to an integer), and
567 IS_NUMBER_NEG if the number is negative (in which case *valuep holds the
568 absolute value).  IS_NUMBER_IN_UV is not set if e notation was used or the
569 number is larger than a UV.
570
571 C<flags> allows only C<PERL_SCAN_TRAILING>, which allows for trailing
572 non-numeric text on an otherwise successful I<grok>, setting
573 C<IS_NUMBER_TRAILING> on the result.
574
575 =for apidoc grok_number
576
577 Identical to grok_number_flags() with flags set to zero.
578
579 =cut
580  */
581 int
582 Perl_grok_number(pTHX_ const char *pv, STRLEN len, UV *valuep)
583 {
584     PERL_ARGS_ASSERT_GROK_NUMBER;
585
586     return grok_number_flags(pv, len, valuep, 0);
587 }
588
589 /*
590 =for apidoc grok_infnan
591
592 Helper for grok_number(), accepts various ways of spelling "infinity"
593 or "not a number", and returns one of the following flag combinations:
594
595   IS_NUMBER_INFINITE
596   IS_NUMBER_NAN
597   IS_NUMBER_INFINITE | IS_NUMBER_NEG
598   IS_NUMBER_NAN | IS_NUMBER_NEG
599   0
600
601 If an infinity or not-a-number is recognized, the *sp will point to
602 one past the end of the recognized string.  If the recognition fails,
603 zero is returned, and the *sp will not move.
604
605 =cut
606 */
607
608 int
609 Perl_grok_infnan(const char** sp, const char* send)
610 {
611     const char* s = *sp;
612     int flags = 0;
613
614     PERL_ARGS_ASSERT_GROK_INFNAN;
615
616     if (*s == '+') {
617         s++; if (s == send) return 0;
618     }
619     else if (*s == '-') {
620         flags |= IS_NUMBER_NEG; /* Yes, -NaN happens. Incorrect but happens. */
621         s++; if (s == send) return 0;
622     }
623
624     if (*s == '1') {
625         /* Visual C: 1.#SNAN, -1.#QNAN, 1#INF, 1#.IND (maybe also 1.#NAN) */
626         s++; if (s == send) return 0;
627         if (*s == '.') {
628             s++; if (s == send) return 0;
629         }
630         if (*s == '#') {
631             s++; if (s == send) return 0;
632         } else
633             return 0;
634     }
635
636     if (isALPHA_FOLD_EQ(*s, 'I')) {
637         /* INF or IND (1.#IND is indeterminate, a certain type of NAN) */
638         s++; if (s == send || isALPHA_FOLD_NE(*s, 'N')) return 0;
639         s++; if (s == send) return 0;
640         if (isALPHA_FOLD_EQ(*s, 'F')) {
641             s++;
642             if (s < send && (isALPHA_FOLD_EQ(*s, 'I'))) {
643                 s++; if (s == send || isALPHA_FOLD_NE(*s, 'N')) return 0;
644                 s++; if (s == send || isALPHA_FOLD_NE(*s, 'I')) return 0;
645                 s++; if (s == send || isALPHA_FOLD_NE(*s, 'T')) return 0;
646                 s++; if (s == send ||
647                          /* allow either Infinity or Infinite */
648                          !(isALPHA_FOLD_EQ(*s, 'Y') ||
649                            isALPHA_FOLD_EQ(*s, 'E'))) return 0;
650                 s++; if (s < send) return 0;
651             } else if (*s)
652                 return 0;
653             flags |= IS_NUMBER_INFINITY | IS_NUMBER_NOT_INT;
654         }
655         else if (isALPHA_FOLD_EQ(*s, 'D')) {
656             s++;
657             flags |= IS_NUMBER_NAN | IS_NUMBER_NOT_INT;
658         } else
659             return 0;
660     }
661     else {
662         /* NAN */
663         if (isALPHA_FOLD_EQ(*s, 'S') || isALPHA_FOLD_EQ(*s, 'Q')) {
664             /* snan, qNaN */
665             /* XXX do something with the snan/qnan difference */
666             s++; if (s == send) return 0;
667         }
668
669         if (isALPHA_FOLD_EQ(*s, 'N')) {
670             s++; if (s == send || isALPHA_FOLD_NE(*s, 'A')) return 0;
671             s++; if (s == send || isALPHA_FOLD_NE(*s, 'N')) return 0;
672             s++;
673
674             flags |= IS_NUMBER_NAN | IS_NUMBER_NOT_INT;
675
676             /* NaN can be followed by various stuff (NaNQ, NaNS), but
677              * there are also multiple different NaN values, and some
678              * implementations output the "payload" values,
679              * e.g. NaN123, NAN(abc), while some implementations just
680              * have weird stuff like NaN%. */
681             s = send;
682         }
683         else
684             return 0;
685     }
686
687     *sp = s;
688     return flags;
689 }
690
691 static const UV uv_max_div_10 = UV_MAX / 10;
692 static const U8 uv_max_mod_10 = UV_MAX % 10;
693
694 int
695 Perl_grok_number_flags(pTHX_ const char *pv, STRLEN len, UV *valuep, U32 flags)
696 {
697   const char *s = pv;
698   const char * const send = pv + len;
699   const char *d;
700   int numtype = 0;
701
702   PERL_ARGS_ASSERT_GROK_NUMBER_FLAGS;
703
704   while (s < send && isSPACE(*s))
705     s++;
706   if (s == send) {
707     return 0;
708   } else if (*s == '-') {
709     s++;
710     numtype = IS_NUMBER_NEG;
711   }
712   else if (*s == '+')
713     s++;
714
715   if (s == send)
716     return 0;
717
718   /* The first digit (after optional sign): note that might
719    * also point to "infinity" or "nan", or "1.#INF". */
720   d = s;
721
722   /* next must be digit or the radix separator or beginning of infinity/nan */
723   if (isDIGIT(*s)) {
724     /* UVs are at least 32 bits, so the first 9 decimal digits cannot
725        overflow.  */
726     UV value = *s - '0';
727     /* This construction seems to be more optimiser friendly.
728        (without it gcc does the isDIGIT test and the *s - '0' separately)
729        With it gcc on arm is managing 6 instructions (6 cycles) per digit.
730        In theory the optimiser could deduce how far to unroll the loop
731        before checking for overflow.  */
732     if (++s < send) {
733       int digit = *s - '0';
734       if (digit >= 0 && digit <= 9) {
735         value = value * 10 + digit;
736         if (++s < send) {
737           digit = *s - '0';
738           if (digit >= 0 && digit <= 9) {
739             value = value * 10 + digit;
740             if (++s < send) {
741               digit = *s - '0';
742               if (digit >= 0 && digit <= 9) {
743                 value = value * 10 + digit;
744                 if (++s < send) {
745                   digit = *s - '0';
746                   if (digit >= 0 && digit <= 9) {
747                     value = value * 10 + digit;
748                     if (++s < send) {
749                       digit = *s - '0';
750                       if (digit >= 0 && digit <= 9) {
751                         value = value * 10 + digit;
752                         if (++s < send) {
753                           digit = *s - '0';
754                           if (digit >= 0 && digit <= 9) {
755                             value = value * 10 + digit;
756                             if (++s < send) {
757                               digit = *s - '0';
758                               if (digit >= 0 && digit <= 9) {
759                                 value = value * 10 + digit;
760                                 if (++s < send) {
761                                   digit = *s - '0';
762                                   if (digit >= 0 && digit <= 9) {
763                                     value = value * 10 + digit;
764                                     if (++s < send) {
765                                       /* Now got 9 digits, so need to check
766                                          each time for overflow.  */
767                                       digit = *s - '0';
768                                       while (digit >= 0 && digit <= 9
769                                              && (value < uv_max_div_10
770                                                  || (value == uv_max_div_10
771                                                      && digit <= uv_max_mod_10))) {
772                                         value = value * 10 + digit;
773                                         if (++s < send)
774                                           digit = *s - '0';
775                                         else
776                                           break;
777                                       }
778                                       if (digit >= 0 && digit <= 9
779                                           && (s < send)) {
780                                         /* value overflowed.
781                                            skip the remaining digits, don't
782                                            worry about setting *valuep.  */
783                                         do {
784                                           s++;
785                                         } while (s < send && isDIGIT(*s));
786                                         numtype |=
787                                           IS_NUMBER_GREATER_THAN_UV_MAX;
788                                         goto skip_value;
789                                       }
790                                     }
791                                   }
792                                 }
793                               }
794                             }
795                           }
796                         }
797                       }
798                     }
799                   }
800                 }
801               }
802             }
803           }
804         }
805       }
806     }
807     numtype |= IS_NUMBER_IN_UV;
808     if (valuep)
809       *valuep = value;
810
811   skip_value:
812     if (GROK_NUMERIC_RADIX(&s, send)) {
813       numtype |= IS_NUMBER_NOT_INT;
814       while (s < send && isDIGIT(*s))  /* optional digits after the radix */
815         s++;
816     }
817   }
818   else if (GROK_NUMERIC_RADIX(&s, send)) {
819     numtype |= IS_NUMBER_NOT_INT | IS_NUMBER_IN_UV; /* valuep assigned below */
820     /* no digits before the radix means we need digits after it */
821     if (s < send && isDIGIT(*s)) {
822       do {
823         s++;
824       } while (s < send && isDIGIT(*s));
825       if (valuep) {
826         /* integer approximation is valid - it's 0.  */
827         *valuep = 0;
828       }
829     }
830     else
831         return 0;
832   }
833
834   if (s > d && s < send) {
835     /* we can have an optional exponent part */
836     if (isALPHA_FOLD_EQ(*s, 'e')) {
837       s++;
838       if (s < send && (*s == '-' || *s == '+'))
839         s++;
840       if (s < send && isDIGIT(*s)) {
841         do {
842           s++;
843         } while (s < send && isDIGIT(*s));
844       }
845       else if (flags & PERL_SCAN_TRAILING)
846         return numtype | IS_NUMBER_TRAILING;
847       else
848         return 0;
849
850       /* The only flag we keep is sign.  Blow away any "it's UV"  */
851       numtype &= IS_NUMBER_NEG;
852       numtype |= IS_NUMBER_NOT_INT;
853     }
854   }
855   while (s < send && isSPACE(*s))
856     s++;
857   if (s >= send)
858     return numtype;
859   if (len == 10 && memEQ(pv, "0 but true", 10)) {
860     if (valuep)
861       *valuep = 0;
862     return IS_NUMBER_IN_UV;
863   }
864   /* We could be e.g. at "Inf" or "NaN", or at the "#" of "1.#INF". */
865   if ((s + 2 < send) && strchr("inqs#", toFOLD(*s))) {
866       /* Really detect inf/nan. Start at d, not s, since the above
867        * code might have already consumed the "1." or "1". */
868       int infnan = Perl_grok_infnan(&d, send);
869       if ((infnan & IS_NUMBER_INFINITY)) {
870           return (numtype | infnan); /* Keep sign for infinity. */
871       }
872       else if ((infnan & IS_NUMBER_NAN)) {
873           return (numtype | infnan) & ~IS_NUMBER_NEG; /* Clear sign for nan. */
874       }
875   }
876   else if (flags & PERL_SCAN_TRAILING) {
877     return numtype | IS_NUMBER_TRAILING;
878   }
879
880   return 0;
881 }
882
883 /*
884 =for apidoc grok_atou
885
886 grok_atou is a safer replacement for atoi and strtol.
887
888 grok_atou parses a C-style zero-byte terminated string, looking for
889 a decimal unsigned integer.
890
891 Returns the unsigned integer, if a valid value can be parsed
892 from the beginning of the string.
893
894 Accepts only the decimal digits '0'..'9'.
895
896 As opposed to atoi or strtol, grok_atou does NOT allow optional
897 leading whitespace, or negative inputs.  If such features are
898 required, the calling code needs to explicitly implement those.
899
900 If a valid value cannot be parsed, returns either zero (if non-digits
901 are met before any digits) or UV_MAX (if the value overflows).
902
903 Note that extraneous leading zeros also count as an overflow
904 (meaning that only "0" is the zero).
905
906 On failure, the *endptr is also set to NULL, unless endptr is NULL.
907
908 Trailing non-digit bytes are allowed if the endptr is non-NULL.
909 On return the *endptr will contain the pointer to the first non-digit byte.
910
911 If the endptr is NULL, the first non-digit byte MUST be
912 the zero byte terminating the pv, or zero will be returned.
913
914 Background: atoi has severe problems with illegal inputs, it cannot be
915 used for incremental parsing, and therefore should be avoided
916 atoi and strtol are also affected by locale settings, which can also be
917 seen as a bug (global state controlled by user environment).
918
919 =cut
920 */
921
922 UV
923 Perl_grok_atou(const char *pv, const char** endptr)
924 {
925     const char* s = pv;
926     const char** eptr;
927     const char* end2; /* Used in case endptr is NULL. */
928     UV val = 0; /* The return value. */
929
930     PERL_ARGS_ASSERT_GROK_ATOU;
931
932     eptr = endptr ? endptr : &end2;
933     if (isDIGIT(*s)) {
934         /* Single-digit inputs are quite common. */
935         val = *s++ - '0';
936         if (isDIGIT(*s)) {
937             /* Extra leading zeros cause overflow. */
938             if (val == 0) {
939                 *eptr = NULL;
940                 return UV_MAX;
941             }
942             while (isDIGIT(*s)) {
943                 /* This could be unrolled like in grok_number(), but
944                  * the expected uses of this are not speed-needy, and
945                  * unlikely to need full 64-bitness. */
946                 U8 digit = *s++ - '0';
947                 if (val < uv_max_div_10 ||
948                     (val == uv_max_div_10 && digit <= uv_max_mod_10)) {
949                     val = val * 10 + digit;
950                 } else {
951                     *eptr = NULL;
952                     return UV_MAX;
953                 }
954             }
955         }
956     }
957     if (s == pv) {
958         *eptr = NULL; /* If no progress, failed to parse anything. */
959         return 0;
960     }
961     if (endptr == NULL && *s) {
962         return 0; /* If endptr is NULL, no trailing non-digits allowed. */
963     }
964     *eptr = s;
965     return val;
966 }
967
968 #ifndef USE_QUADMATH
969 STATIC NV
970 S_mulexp10(NV value, I32 exponent)
971 {
972     NV result = 1.0;
973     NV power = 10.0;
974     bool negative = 0;
975     I32 bit;
976
977     if (exponent == 0)
978         return value;
979     if (value == 0)
980         return (NV)0;
981
982     /* On OpenVMS VAX we by default use the D_FLOAT double format,
983      * and that format does not have *easy* capabilities [1] for
984      * overflowing doubles 'silently' as IEEE fp does.  We also need 
985      * to support G_FLOAT on both VAX and Alpha, and though the exponent 
986      * range is much larger than D_FLOAT it still doesn't do silent 
987      * overflow.  Therefore we need to detect early whether we would 
988      * overflow (this is the behaviour of the native string-to-float 
989      * conversion routines, and therefore of native applications, too).
990      *
991      * [1] Trying to establish a condition handler to trap floating point
992      *     exceptions is not a good idea. */
993
994     /* In UNICOS and in certain Cray models (such as T90) there is no
995      * IEEE fp, and no way at all from C to catch fp overflows gracefully.
996      * There is something you can do if you are willing to use some
997      * inline assembler: the instruction is called DFI-- but that will
998      * disable *all* floating point interrupts, a little bit too large
999      * a hammer.  Therefore we need to catch potential overflows before
1000      * it's too late. */
1001
1002 #if ((defined(VMS) && !defined(_IEEE_FP)) || defined(_UNICOS)) && defined(NV_MAX_10_EXP)
1003     STMT_START {
1004         const NV exp_v = log10(value);
1005         if (exponent >= NV_MAX_10_EXP || exponent + exp_v >= NV_MAX_10_EXP)
1006             return NV_MAX;
1007         if (exponent < 0) {
1008             if (-(exponent + exp_v) >= NV_MAX_10_EXP)
1009                 return 0.0;
1010             while (-exponent >= NV_MAX_10_EXP) {
1011                 /* combination does not overflow, but 10^(-exponent) does */
1012                 value /= 10;
1013                 ++exponent;
1014             }
1015         }
1016     } STMT_END;
1017 #endif
1018
1019     if (exponent < 0) {
1020         negative = 1;
1021         exponent = -exponent;
1022 #ifdef NV_MAX_10_EXP
1023         /* for something like 1234 x 10^-309, the action of calculating
1024          * the intermediate value 10^309 then returning 1234 / (10^309)
1025          * will fail, since 10^309 becomes infinity. In this case try to
1026          * refactor it as 123 / (10^308) etc.
1027          */
1028         while (value && exponent > NV_MAX_10_EXP) {
1029             exponent--;
1030             value /= 10;
1031         }
1032 #endif
1033     }
1034     for (bit = 1; exponent; bit <<= 1) {
1035         if (exponent & bit) {
1036             exponent ^= bit;
1037             result *= power;
1038             /* Floating point exceptions are supposed to be turned off,
1039              *  but if we're obviously done, don't risk another iteration.  
1040              */
1041              if (exponent == 0) break;
1042         }
1043         power *= power;
1044     }
1045     return negative ? value / result : value * result;
1046 }
1047 #endif /* #ifndef USE_QUADMATH */
1048
1049 NV
1050 Perl_my_atof(pTHX_ const char* s)
1051 {
1052     NV x = 0.0;
1053 #ifdef USE_QUADMATH
1054     Perl_my_atof2(aTHX_ s, &x);
1055     return x;
1056 #else
1057 #  ifdef USE_LOCALE_NUMERIC
1058     PERL_ARGS_ASSERT_MY_ATOF;
1059
1060     {
1061         DECLARE_STORE_LC_NUMERIC_SET_TO_NEEDED();
1062         if (PL_numeric_radix_sv && IN_LC(LC_NUMERIC)) {
1063             const char *standard = NULL, *local = NULL;
1064             bool use_standard_radix;
1065
1066             /* Look through the string for the first thing that looks like a
1067              * decimal point: either the value in the current locale or the
1068              * standard fallback of '.'. The one which appears earliest in the
1069              * input string is the one that we should have atof look for. Note
1070              * that we have to determine this beforehand because on some
1071              * systems, Perl_atof2 is just a wrapper around the system's atof.
1072              * */
1073             standard = strchr(s, '.');
1074             local = strstr(s, SvPV_nolen(PL_numeric_radix_sv));
1075
1076             use_standard_radix = standard && (!local || standard < local);
1077
1078             if (use_standard_radix)
1079                 SET_NUMERIC_STANDARD();
1080
1081             Perl_atof2(s, x);
1082
1083             if (use_standard_radix)
1084                 SET_NUMERIC_LOCAL();
1085         }
1086         else
1087             Perl_atof2(s, x);
1088         RESTORE_LC_NUMERIC();
1089     }
1090 #  else
1091     Perl_atof2(s, x);
1092 #  endif
1093 #endif
1094     return x;
1095 }
1096
1097 static char*
1098 S_my_atof_infnan(const char* s, bool negative, const char* send, NV* value)
1099 {
1100     const char *p0 = negative ? s - 1 : s;
1101     const char *p = p0;
1102     int infnan = grok_infnan(&p, send);
1103     if (infnan && p != p0) {
1104         /* If we can generate inf/nan directly, let's do so. */
1105 #ifdef NV_INF
1106         if ((infnan & IS_NUMBER_INFINITY)) {
1107             *value = (infnan & IS_NUMBER_NEG) ? -NV_INF: NV_INF;
1108             return (char*)p;
1109         }
1110 #endif
1111 #ifdef NV_NAN
1112         if ((infnan & IS_NUMBER_NAN)) {
1113             *value = NV_NAN;
1114             return (char*)p;
1115         }
1116 #endif
1117 #ifdef Perl_strtod
1118         /* If still here, we didn't have either NV_INF or NV_NAN,
1119          * and can try falling back to native strtod/strtold.
1120          *
1121          * (Though, are our NV_INF or NV_NAN ever not defined?)
1122          *
1123          * The native interface might not recognize all the possible
1124          * inf/nan strings Perl recognizes.  What we can try
1125          * is to try faking the input.  We will try inf/-inf/nan
1126          * as the most promising/portable input. */
1127         {
1128             const char* fake = NULL;
1129             char* endp;
1130             NV nv;
1131             if ((infnan & IS_NUMBER_INFINITY)) {
1132                 fake = ((infnan & IS_NUMBER_NEG)) ? "-inf" : "inf";
1133             }
1134             else if ((infnan & IS_NUMBER_NAN)) {
1135                 fake = "nan";
1136             }
1137             assert(fake);
1138             nv = Perl_strtod(fake, &endp);
1139             if (fake != endp) {
1140                 if ((infnan & IS_NUMBER_INFINITY)) {
1141 #ifdef Perl_isinf
1142                     if (Perl_isinf(nv))
1143                         *value = nv;
1144 #else
1145                     /* last resort, may generate SIGFPE */
1146                     *value = Perl_exp((NV)1e9);
1147                     if ((infnan & IS_NUMBER_NEG))
1148                         *value = -*value;
1149 #endif
1150                     return (char*)p; /* p, not endp */
1151                 }
1152                 else if ((infnan & IS_NUMBER_NAN)) {
1153 #ifdef Perl_isnan
1154                     if (Perl_isnan(nv))
1155                         *value = nv;
1156 #else
1157                     /* last resort, may generate SIGFPE */
1158                     *value = Perl_log((NV)-1.0);
1159 #endif
1160                     return (char*)p; /* p, not endp */
1161                 }
1162             }
1163         }
1164 #endif /* #ifdef Perl_strtod */
1165     }
1166     return NULL;
1167 }
1168
1169 char*
1170 Perl_my_atof2(pTHX_ const char* orig, NV* value)
1171 {
1172     const char* s = orig;
1173     NV result[3] = {0.0, 0.0, 0.0};
1174 #if defined(USE_PERL_ATOF) || defined(USE_QUADMATH)
1175     const char* send = s + strlen(orig); /* one past the last */
1176     bool negative = 0;
1177 #endif
1178 #if defined(USE_PERL_ATOF) && !defined(USE_QUADMATH)
1179     UV accumulator[2] = {0,0};  /* before/after dp */
1180     bool seen_digit = 0;
1181     I32 exp_adjust[2] = {0,0};
1182     I32 exp_acc[2] = {-1, -1};
1183     /* the current exponent adjust for the accumulators */
1184     I32 exponent = 0;
1185     I32 seen_dp  = 0;
1186     I32 digit = 0;
1187     I32 old_digit = 0;
1188     I32 sig_digits = 0; /* noof significant digits seen so far */
1189 #endif
1190
1191 #if defined(USE_PERL_ATOF) || defined(USE_QUADMATH)
1192     PERL_ARGS_ASSERT_MY_ATOF2;
1193
1194     /* leading whitespace */
1195     while (isSPACE(*s))
1196         ++s;
1197
1198     /* sign */
1199     switch (*s) {
1200         case '-':
1201             negative = 1;
1202             /* FALLTHROUGH */
1203         case '+':
1204             ++s;
1205     }
1206 #endif
1207
1208 #ifdef USE_QUADMATH
1209     {
1210         char* endp;
1211         if ((endp = S_my_atof_infnan(s, negative, send, value)))
1212             return endp;
1213         result[2] = strtoflt128(s, &endp);
1214         if (s != endp) {
1215             *value = negative ? -result[2] : result[2];
1216             return endp;
1217         }
1218         return NULL;
1219     }
1220 #elif defined(USE_PERL_ATOF)
1221
1222 /* There is no point in processing more significant digits
1223  * than the NV can hold. Note that NV_DIG is a lower-bound value,
1224  * while we need an upper-bound value. We add 2 to account for this;
1225  * since it will have been conservative on both the first and last digit.
1226  * For example a 32-bit mantissa with an exponent of 4 would have
1227  * exact values in the set
1228  *               4
1229  *               8
1230  *              ..
1231  *     17179869172
1232  *     17179869176
1233  *     17179869180
1234  *
1235  * where for the purposes of calculating NV_DIG we would have to discount
1236  * both the first and last digit, since neither can hold all values from
1237  * 0..9; but for calculating the value we must examine those two digits.
1238  */
1239 #ifdef MAX_SIG_DIG_PLUS
1240     /* It is not necessarily the case that adding 2 to NV_DIG gets all the
1241        possible digits in a NV, especially if NVs are not IEEE compliant
1242        (e.g., long doubles on IRIX) - Allen <allens@cpan.org> */
1243 # define MAX_SIG_DIGITS (NV_DIG+MAX_SIG_DIG_PLUS)
1244 #else
1245 # define MAX_SIG_DIGITS (NV_DIG+2)
1246 #endif
1247
1248 /* the max number we can accumulate in a UV, and still safely do 10*N+9 */
1249 #define MAX_ACCUMULATE ( (UV) ((UV_MAX - 9)/10))
1250
1251     {
1252         const char* endp;
1253         if ((endp = S_my_atof_infnan(s, negative, send, value)))
1254             return (char*)endp;
1255     }
1256
1257     /* we accumulate digits into an integer; when this becomes too
1258      * large, we add the total to NV and start again */
1259
1260     while (1) {
1261         if (isDIGIT(*s)) {
1262             seen_digit = 1;
1263             old_digit = digit;
1264             digit = *s++ - '0';
1265             if (seen_dp)
1266                 exp_adjust[1]++;
1267
1268             /* don't start counting until we see the first significant
1269              * digit, eg the 5 in 0.00005... */
1270             if (!sig_digits && digit == 0)
1271                 continue;
1272
1273             if (++sig_digits > MAX_SIG_DIGITS) {
1274                 /* limits of precision reached */
1275                 if (digit > 5) {
1276                     ++accumulator[seen_dp];
1277                 } else if (digit == 5) {
1278                     if (old_digit % 2) { /* round to even - Allen */
1279                         ++accumulator[seen_dp];
1280                     }
1281                 }
1282                 if (seen_dp) {
1283                     exp_adjust[1]--;
1284                 } else {
1285                     exp_adjust[0]++;
1286                 }
1287                 /* skip remaining digits */
1288                 while (isDIGIT(*s)) {
1289                     ++s;
1290                     if (! seen_dp) {
1291                         exp_adjust[0]++;
1292                     }
1293                 }
1294                 /* warn of loss of precision? */
1295             }
1296             else {
1297                 if (accumulator[seen_dp] > MAX_ACCUMULATE) {
1298                     /* add accumulator to result and start again */
1299                     result[seen_dp] = S_mulexp10(result[seen_dp],
1300                                                  exp_acc[seen_dp])
1301                         + (NV)accumulator[seen_dp];
1302                     accumulator[seen_dp] = 0;
1303                     exp_acc[seen_dp] = 0;
1304                 }
1305                 accumulator[seen_dp] = accumulator[seen_dp] * 10 + digit;
1306                 ++exp_acc[seen_dp];
1307             }
1308         }
1309         else if (!seen_dp && GROK_NUMERIC_RADIX(&s, send)) {
1310             seen_dp = 1;
1311             if (sig_digits > MAX_SIG_DIGITS) {
1312                 do {
1313                     ++s;
1314                 } while (isDIGIT(*s));
1315                 break;
1316             }
1317         }
1318         else {
1319             break;
1320         }
1321     }
1322
1323     result[0] = S_mulexp10(result[0], exp_acc[0]) + (NV)accumulator[0];
1324     if (seen_dp) {
1325         result[1] = S_mulexp10(result[1], exp_acc[1]) + (NV)accumulator[1];
1326     }
1327
1328     if (seen_digit && (isALPHA_FOLD_EQ(*s, 'e'))) {
1329         bool expnegative = 0;
1330
1331         ++s;
1332         switch (*s) {
1333             case '-':
1334                 expnegative = 1;
1335                 /* FALLTHROUGH */
1336             case '+':
1337                 ++s;
1338         }
1339         while (isDIGIT(*s))
1340             exponent = exponent * 10 + (*s++ - '0');
1341         if (expnegative)
1342             exponent = -exponent;
1343     }
1344
1345
1346
1347     /* now apply the exponent */
1348
1349     if (seen_dp) {
1350         result[2] = S_mulexp10(result[0],exponent+exp_adjust[0])
1351                 + S_mulexp10(result[1],exponent-exp_adjust[1]);
1352     } else {
1353         result[2] = S_mulexp10(result[0],exponent+exp_adjust[0]);
1354     }
1355
1356     /* now apply the sign */
1357     if (negative)
1358         result[2] = -result[2];
1359 #endif /* USE_PERL_ATOF */
1360     *value = result[2];
1361     return (char *)s;
1362 }
1363
1364 /*
1365 =for apidoc isinfnan
1366
1367 Perl_isinfnan() is utility function that returns true if the NV
1368 argument is either an infinity or a NaN, false otherwise.  To test
1369 in more detail, use Perl_isinf() and Perl_isnan().
1370
1371 This is also the logical inverse of Perl_isfinite().
1372
1373 =cut
1374 */
1375 bool
1376 Perl_isinfnan(NV nv)
1377 {
1378 #ifdef Perl_isinf
1379     if (Perl_isinf(nv))
1380         return TRUE;
1381 #endif
1382 #ifdef Perl_isnan
1383     if (Perl_isnan(nv))
1384         return TRUE;
1385 #endif
1386     return FALSE;
1387 }
1388
1389 /*
1390 =for apidoc
1391
1392 Checks whether the argument would be either an infinity or NaN when used
1393 as a number, but is careful not to trigger non-numeric or uninitialized
1394 warnings.  it assumes the caller has done SvGETMAGIC(sv) already.
1395
1396 =cut
1397 */
1398
1399 bool
1400 Perl_isinfnansv(pTHX_ SV *sv)
1401 {
1402     PERL_ARGS_ASSERT_ISINFNANSV;
1403     if (!SvOK(sv))
1404         return FALSE;
1405     if (SvNOKp(sv))
1406         return Perl_isinfnan(SvNVX(sv));
1407     if (SvIOKp(sv))
1408         return FALSE;
1409     {
1410         STRLEN len;
1411         const char *s = SvPV_nomg_const(sv, len);
1412         return cBOOL(grok_infnan(&s, s+len));
1413     }
1414 }
1415
1416 #ifndef HAS_MODFL
1417 /* C99 has truncl, pre-C99 Solaris had aintl.  We can use either with
1418  * copysignl to emulate modfl, which is in some platforms missing or
1419  * broken. */
1420 #  if defined(HAS_TRUNCL) && defined(HAS_COPYSIGNL)
1421 long double
1422 Perl_my_modfl(long double x, long double *ip)
1423 {
1424     *ip = truncl(x);
1425     return (x == *ip ? copysignl(0.0L, x) : x - *ip);
1426 }
1427 #  elif defined(HAS_AINTL) && defined(HAS_COPYSIGNL)
1428 long double
1429 Perl_my_modfl(long double x, long double *ip)
1430 {
1431     *ip = aintl(x);
1432     return (x == *ip ? copysignl(0.0L, x) : x - *ip);
1433 }
1434 #  endif
1435 #endif
1436
1437 /* Similarly, with ilobl and scalbnl we can emulate frexpl. */
1438 #if ! defined(HAS_FREXPL) && defined(HAS_ILOGBL) && defined(HAS_SCALBNL)
1439 long double
1440 Perl_my_frexpl(long double x, int *e) {
1441     *e = x == 0.0L ? 0 : ilogbl(x) + 1;
1442     return (scalbnl(x, -*e));
1443 }
1444 #endif
1445
1446 /*
1447 =for apidoc Perl_signbit
1448
1449 Return a non-zero integer if the sign bit on an NV is set, and 0 if
1450 it is not.  
1451
1452 If Configure detects this system has a signbit() that will work with
1453 our NVs, then we just use it via the #define in perl.h.  Otherwise,
1454 fall back on this implementation.  The main use of this function
1455 is catching -0.0.
1456
1457 Configure notes:  This function is called 'Perl_signbit' instead of a
1458 plain 'signbit' because it is easy to imagine a system having a signbit()
1459 function or macro that doesn't happen to work with our particular choice
1460 of NVs.  We shouldn't just re-#define signbit as Perl_signbit and expect
1461 the standard system headers to be happy.  Also, this is a no-context
1462 function (no pTHX_) because Perl_signbit() is usually re-#defined in
1463 perl.h as a simple macro call to the system's signbit().
1464 Users should just always call Perl_signbit().
1465
1466 =cut
1467 */
1468 #if !defined(HAS_SIGNBIT)
1469 int
1470 Perl_signbit(NV x) {
1471 #  ifdef Perl_fp_class_nzero
1472     if (x == 0)
1473         return Perl_fp_class_nzero(x);
1474 #  endif
1475     return (x < 0.0) ? 1 : 0;
1476 }
1477 #endif
1478
1479 /*
1480  * Local variables:
1481  * c-indentation-style: bsd
1482  * c-basic-offset: 4
1483  * indent-tabs-mode: nil
1484  * End:
1485  *
1486  * ex: set ts=8 sts=4 sw=4 et:
1487  */