Home | History | Annotate | Line # | Download | only in gas
atof-generic.c revision 1.1.1.5
      1      1.1     skrll /* atof_generic.c - turn a string of digits into a Flonum
      2  1.1.1.5  christos    Copyright (C) 1987-2018 Free Software Foundation, Inc.
      3      1.1     skrll 
      4      1.1     skrll    This file is part of GAS, the GNU Assembler.
      5      1.1     skrll 
      6      1.1     skrll    GAS is free software; you can redistribute it and/or modify
      7      1.1     skrll    it under the terms of the GNU General Public License as published by
      8      1.1     skrll    the Free Software Foundation; either version 3, or (at your option)
      9      1.1     skrll    any later version.
     10      1.1     skrll 
     11      1.1     skrll    GAS is distributed in the hope that it will be useful, but WITHOUT
     12      1.1     skrll    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
     13      1.1     skrll    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
     14      1.1     skrll    License for more details.
     15      1.1     skrll 
     16      1.1     skrll    You should have received a copy of the GNU General Public License
     17      1.1     skrll    along with GAS; see the file COPYING.  If not, write to the Free
     18      1.1     skrll    Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
     19      1.1     skrll    02110-1301, USA.  */
     20      1.1     skrll 
     21      1.1     skrll #include "as.h"
     22      1.1     skrll #include "safe-ctype.h"
     23      1.1     skrll 
     24      1.1     skrll #ifndef FALSE
     25      1.1     skrll #define FALSE (0)
     26      1.1     skrll #endif
     27      1.1     skrll #ifndef TRUE
     28      1.1     skrll #define TRUE  (1)
     29      1.1     skrll #endif
     30      1.1     skrll 
     31      1.1     skrll #ifdef TRACE
     32      1.1     skrll static void flonum_print (const FLONUM_TYPE *);
     33      1.1     skrll #endif
     34      1.1     skrll 
     35      1.1     skrll #define ASSUME_DECIMAL_MARK_IS_DOT
     36      1.1     skrll 
     37      1.1     skrll /***********************************************************************\
     38      1.1     skrll  *									*
     39      1.1     skrll  *	Given a string of decimal digits , with optional decimal	*
     40      1.1     skrll  *	mark and optional decimal exponent (place value) of the		*
     41      1.1     skrll  *	lowest_order decimal digit: produce a floating point		*
     42      1.1     skrll  *	number. The number is 'generic' floating point: our		*
     43      1.1     skrll  *	caller will encode it for a specific machine architecture.	*
     44      1.1     skrll  *									*
     45      1.1     skrll  *	Assumptions							*
     46      1.1     skrll  *		uses base (radix) 2					*
     47      1.1     skrll  *		this machine uses 2's complement binary integers	*
     48      1.1     skrll  *		target flonums use "      "         "       "		*
     49      1.1     skrll  *		target flonums exponents fit in a long			*
     50      1.1     skrll  *									*
     51      1.1     skrll  \***********************************************************************/
     52      1.1     skrll 
     53      1.1     skrll /*
     54      1.1     skrll 
     55      1.1     skrll   Syntax:
     56      1.1     skrll 
     57      1.1     skrll   <flonum> ::= <optional-sign> <decimal-number> <optional-exponent>
     58      1.1     skrll   <optional-sign> ::= '+' | '-' | {empty}
     59      1.1     skrll   <decimal-number> ::= <integer>
     60      1.1     skrll   | <integer> <radix-character>
     61      1.1     skrll   | <integer> <radix-character> <integer>
     62      1.1     skrll   | <radix-character> <integer>
     63      1.1     skrll 
     64      1.1     skrll   <optional-exponent> ::= {empty}
     65      1.1     skrll   | <exponent-character> <optional-sign> <integer>
     66      1.1     skrll 
     67      1.1     skrll   <integer> ::= <digit> | <digit> <integer>
     68      1.1     skrll   <digit> ::= '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9'
     69      1.1     skrll   <exponent-character> ::= {one character from "string_of_decimal_exponent_marks"}
     70      1.1     skrll   <radix-character> ::= {one character from "string_of_decimal_marks"}
     71      1.1     skrll 
     72      1.1     skrll   */
     73      1.1     skrll 
     74      1.1     skrll int
     75      1.1     skrll atof_generic (/* return pointer to just AFTER number we read.  */
     76      1.1     skrll 	      char **address_of_string_pointer,
     77      1.1     skrll 	      /* At most one per number.  */
     78      1.1     skrll 	      const char *string_of_decimal_marks,
     79      1.1     skrll 	      const char *string_of_decimal_exponent_marks,
     80      1.1     skrll 	      FLONUM_TYPE *address_of_generic_floating_point_number)
     81      1.1     skrll {
     82      1.1     skrll   int return_value;		/* 0 means OK.  */
     83      1.1     skrll   char *first_digit;
     84      1.1     skrll   unsigned int number_of_digits_before_decimal;
     85      1.1     skrll   unsigned int number_of_digits_after_decimal;
     86      1.1     skrll   long decimal_exponent;
     87      1.1     skrll   unsigned int number_of_digits_available;
     88      1.1     skrll   char digits_sign_char;
     89      1.1     skrll 
     90      1.1     skrll   /*
     91      1.1     skrll    * Scan the input string, abstracting (1)digits (2)decimal mark (3) exponent.
     92      1.1     skrll    * It would be simpler to modify the string, but we don't; just to be nice
     93      1.1     skrll    * to caller.
     94      1.1     skrll    * We need to know how many digits we have, so we can allocate space for
     95      1.1     skrll    * the digits' value.
     96      1.1     skrll    */
     97      1.1     skrll 
     98      1.1     skrll   char *p;
     99      1.1     skrll   char c;
    100      1.1     skrll   int seen_significant_digit;
    101      1.1     skrll 
    102      1.1     skrll #ifdef ASSUME_DECIMAL_MARK_IS_DOT
    103  1.1.1.2  christos   gas_assert (string_of_decimal_marks[0] == '.'
    104      1.1     skrll 	  && string_of_decimal_marks[1] == 0);
    105      1.1     skrll #define IS_DECIMAL_MARK(c)	((c) == '.')
    106      1.1     skrll #else
    107      1.1     skrll #define IS_DECIMAL_MARK(c)	(0 != strchr (string_of_decimal_marks, (c)))
    108      1.1     skrll #endif
    109      1.1     skrll 
    110      1.1     skrll   first_digit = *address_of_string_pointer;
    111      1.1     skrll   c = *first_digit;
    112      1.1     skrll 
    113      1.1     skrll   if (c == '-' || c == '+')
    114      1.1     skrll     {
    115      1.1     skrll       digits_sign_char = c;
    116      1.1     skrll       first_digit++;
    117      1.1     skrll     }
    118      1.1     skrll   else
    119      1.1     skrll     digits_sign_char = '+';
    120      1.1     skrll 
    121      1.1     skrll   switch (first_digit[0])
    122      1.1     skrll     {
    123      1.1     skrll     case 'n':
    124      1.1     skrll     case 'N':
    125      1.1     skrll       if (!strncasecmp ("nan", first_digit, 3))
    126      1.1     skrll 	{
    127      1.1     skrll 	  address_of_generic_floating_point_number->sign = 0;
    128      1.1     skrll 	  address_of_generic_floating_point_number->exponent = 0;
    129      1.1     skrll 	  address_of_generic_floating_point_number->leader =
    130      1.1     skrll 	    address_of_generic_floating_point_number->low;
    131      1.1     skrll 	  *address_of_string_pointer = first_digit + 3;
    132      1.1     skrll 	  return 0;
    133      1.1     skrll 	}
    134      1.1     skrll       break;
    135      1.1     skrll 
    136      1.1     skrll     case 'i':
    137      1.1     skrll     case 'I':
    138      1.1     skrll       if (!strncasecmp ("inf", first_digit, 3))
    139      1.1     skrll 	{
    140      1.1     skrll 	  address_of_generic_floating_point_number->sign =
    141      1.1     skrll 	    digits_sign_char == '+' ? 'P' : 'N';
    142      1.1     skrll 	  address_of_generic_floating_point_number->exponent = 0;
    143      1.1     skrll 	  address_of_generic_floating_point_number->leader =
    144      1.1     skrll 	    address_of_generic_floating_point_number->low;
    145      1.1     skrll 
    146      1.1     skrll 	  first_digit += 3;
    147      1.1     skrll 	  if (!strncasecmp ("inity", first_digit, 5))
    148      1.1     skrll 	    first_digit += 5;
    149      1.1     skrll 
    150      1.1     skrll 	  *address_of_string_pointer = first_digit;
    151      1.1     skrll 
    152      1.1     skrll 	  return 0;
    153      1.1     skrll 	}
    154      1.1     skrll       break;
    155      1.1     skrll     }
    156      1.1     skrll 
    157      1.1     skrll   number_of_digits_before_decimal = 0;
    158      1.1     skrll   number_of_digits_after_decimal = 0;
    159      1.1     skrll   decimal_exponent = 0;
    160      1.1     skrll   seen_significant_digit = 0;
    161      1.1     skrll   for (p = first_digit;
    162      1.1     skrll        (((c = *p) != '\0')
    163      1.1     skrll 	&& (!c || !IS_DECIMAL_MARK (c))
    164      1.1     skrll 	&& (!c || !strchr (string_of_decimal_exponent_marks, c)));
    165      1.1     skrll        p++)
    166      1.1     skrll     {
    167      1.1     skrll       if (ISDIGIT (c))
    168      1.1     skrll 	{
    169      1.1     skrll 	  if (seen_significant_digit || c > '0')
    170      1.1     skrll 	    {
    171      1.1     skrll 	      ++number_of_digits_before_decimal;
    172      1.1     skrll 	      seen_significant_digit = 1;
    173      1.1     skrll 	    }
    174      1.1     skrll 	  else
    175      1.1     skrll 	    {
    176      1.1     skrll 	      first_digit++;
    177      1.1     skrll 	    }
    178      1.1     skrll 	}
    179      1.1     skrll       else
    180      1.1     skrll 	{
    181      1.1     skrll 	  break;		/* p -> char after pre-decimal digits.  */
    182      1.1     skrll 	}
    183      1.1     skrll     }				/* For each digit before decimal mark.  */
    184      1.1     skrll 
    185      1.1     skrll #ifndef OLD_FLOAT_READS
    186      1.1     skrll   /* Ignore trailing 0's after the decimal point.  The original code here
    187      1.1     skrll    * (ifdef'd out) does not do this, and numbers like
    188      1.1     skrll    *	4.29496729600000000000e+09	(2**31)
    189      1.1     skrll    * come out inexact for some reason related to length of the digit
    190      1.1     skrll    * string.
    191      1.1     skrll    */
    192      1.1     skrll   if (c && IS_DECIMAL_MARK (c))
    193      1.1     skrll     {
    194      1.1     skrll       unsigned int zeros = 0;	/* Length of current string of zeros */
    195      1.1     skrll 
    196      1.1     skrll       for (p++; (c = *p) && ISDIGIT (c); p++)
    197      1.1     skrll 	{
    198      1.1     skrll 	  if (c == '0')
    199      1.1     skrll 	    {
    200      1.1     skrll 	      zeros++;
    201      1.1     skrll 	    }
    202      1.1     skrll 	  else
    203      1.1     skrll 	    {
    204      1.1     skrll 	      number_of_digits_after_decimal += 1 + zeros;
    205      1.1     skrll 	      zeros = 0;
    206      1.1     skrll 	    }
    207      1.1     skrll 	}
    208      1.1     skrll     }
    209      1.1     skrll #else
    210      1.1     skrll   if (c && IS_DECIMAL_MARK (c))
    211      1.1     skrll     {
    212      1.1     skrll       for (p++;
    213      1.1     skrll 	   (((c = *p) != '\0')
    214      1.1     skrll 	    && (!c || !strchr (string_of_decimal_exponent_marks, c)));
    215      1.1     skrll 	   p++)
    216      1.1     skrll 	{
    217      1.1     skrll 	  if (ISDIGIT (c))
    218      1.1     skrll 	    {
    219      1.1     skrll 	      /* This may be retracted below.  */
    220      1.1     skrll 	      number_of_digits_after_decimal++;
    221      1.1     skrll 
    222      1.1     skrll 	      if ( /* seen_significant_digit || */ c > '0')
    223      1.1     skrll 		{
    224      1.1     skrll 		  seen_significant_digit = TRUE;
    225      1.1     skrll 		}
    226      1.1     skrll 	    }
    227      1.1     skrll 	  else
    228      1.1     skrll 	    {
    229      1.1     skrll 	      if (!seen_significant_digit)
    230      1.1     skrll 		{
    231      1.1     skrll 		  number_of_digits_after_decimal = 0;
    232      1.1     skrll 		}
    233      1.1     skrll 	      break;
    234      1.1     skrll 	    }
    235      1.1     skrll 	}			/* For each digit after decimal mark.  */
    236      1.1     skrll     }
    237      1.1     skrll 
    238      1.1     skrll   while (number_of_digits_after_decimal
    239      1.1     skrll 	 && first_digit[number_of_digits_before_decimal
    240      1.1     skrll 			+ number_of_digits_after_decimal] == '0')
    241      1.1     skrll     --number_of_digits_after_decimal;
    242      1.1     skrll #endif
    243      1.1     skrll 
    244      1.1     skrll   if (flag_m68k_mri)
    245      1.1     skrll     {
    246      1.1     skrll       while (c == '_')
    247      1.1     skrll 	c = *++p;
    248      1.1     skrll     }
    249      1.1     skrll   if (c && strchr (string_of_decimal_exponent_marks, c))
    250      1.1     skrll     {
    251      1.1     skrll       char digits_exponent_sign_char;
    252      1.1     skrll 
    253      1.1     skrll       c = *++p;
    254      1.1     skrll       if (flag_m68k_mri)
    255      1.1     skrll 	{
    256      1.1     skrll 	  while (c == '_')
    257      1.1     skrll 	    c = *++p;
    258      1.1     skrll 	}
    259      1.1     skrll       if (c && strchr ("+-", c))
    260      1.1     skrll 	{
    261      1.1     skrll 	  digits_exponent_sign_char = c;
    262      1.1     skrll 	  c = *++p;
    263      1.1     skrll 	}
    264      1.1     skrll       else
    265      1.1     skrll 	{
    266      1.1     skrll 	  digits_exponent_sign_char = '+';
    267      1.1     skrll 	}
    268      1.1     skrll 
    269      1.1     skrll       for (; (c); c = *++p)
    270      1.1     skrll 	{
    271      1.1     skrll 	  if (ISDIGIT (c))
    272      1.1     skrll 	    {
    273      1.1     skrll 	      decimal_exponent = decimal_exponent * 10 + c - '0';
    274      1.1     skrll 	      /*
    275      1.1     skrll 	       * BUG! If we overflow here, we lose!
    276      1.1     skrll 	       */
    277      1.1     skrll 	    }
    278      1.1     skrll 	  else
    279      1.1     skrll 	    {
    280      1.1     skrll 	      break;
    281      1.1     skrll 	    }
    282      1.1     skrll 	}
    283      1.1     skrll 
    284      1.1     skrll       if (digits_exponent_sign_char == '-')
    285      1.1     skrll 	{
    286      1.1     skrll 	  decimal_exponent = -decimal_exponent;
    287      1.1     skrll 	}
    288      1.1     skrll     }
    289      1.1     skrll 
    290      1.1     skrll   *address_of_string_pointer = p;
    291      1.1     skrll 
    292      1.1     skrll   number_of_digits_available =
    293      1.1     skrll     number_of_digits_before_decimal + number_of_digits_after_decimal;
    294      1.1     skrll   return_value = 0;
    295      1.1     skrll   if (number_of_digits_available == 0)
    296      1.1     skrll     {
    297      1.1     skrll       address_of_generic_floating_point_number->exponent = 0;	/* Not strictly necessary */
    298      1.1     skrll       address_of_generic_floating_point_number->leader
    299      1.1     skrll 	= -1 + address_of_generic_floating_point_number->low;
    300      1.1     skrll       address_of_generic_floating_point_number->sign = digits_sign_char;
    301      1.1     skrll       /* We have just concocted (+/-)0.0E0 */
    302      1.1     skrll 
    303      1.1     skrll     }
    304      1.1     skrll   else
    305      1.1     skrll     {
    306      1.1     skrll       int count;		/* Number of useful digits left to scan.  */
    307      1.1     skrll 
    308  1.1.1.4  christos       LITTLENUM_TYPE *temporary_binary_low = NULL;
    309  1.1.1.4  christos       LITTLENUM_TYPE *power_binary_low = NULL;
    310      1.1     skrll       LITTLENUM_TYPE *digits_binary_low;
    311      1.1     skrll       unsigned int precision;
    312      1.1     skrll       unsigned int maximum_useful_digits;
    313      1.1     skrll       unsigned int number_of_digits_to_use;
    314      1.1     skrll       unsigned int more_than_enough_bits_for_digits;
    315      1.1     skrll       unsigned int more_than_enough_littlenums_for_digits;
    316      1.1     skrll       unsigned int size_of_digits_in_littlenums;
    317      1.1     skrll       unsigned int size_of_digits_in_chars;
    318      1.1     skrll       FLONUM_TYPE power_of_10_flonum;
    319      1.1     skrll       FLONUM_TYPE digits_flonum;
    320      1.1     skrll 
    321      1.1     skrll       precision = (address_of_generic_floating_point_number->high
    322      1.1     skrll 		   - address_of_generic_floating_point_number->low
    323      1.1     skrll 		   + 1);	/* Number of destination littlenums.  */
    324      1.1     skrll 
    325      1.1     skrll       /* Includes guard bits (two littlenums worth) */
    326      1.1     skrll       maximum_useful_digits = (((precision - 2))
    327      1.1     skrll 			       * ( (LITTLENUM_NUMBER_OF_BITS))
    328      1.1     skrll 			       * 1000000 / 3321928)
    329      1.1     skrll 	+ 2;			/* 2 :: guard digits.  */
    330      1.1     skrll 
    331      1.1     skrll       if (number_of_digits_available > maximum_useful_digits)
    332      1.1     skrll 	{
    333      1.1     skrll 	  number_of_digits_to_use = maximum_useful_digits;
    334      1.1     skrll 	}
    335      1.1     skrll       else
    336      1.1     skrll 	{
    337      1.1     skrll 	  number_of_digits_to_use = number_of_digits_available;
    338      1.1     skrll 	}
    339      1.1     skrll 
    340      1.1     skrll       /* Cast these to SIGNED LONG first, otherwise, on systems with
    341      1.1     skrll 	 LONG wider than INT (such as Alpha OSF/1), unsignedness may
    342      1.1     skrll 	 cause unexpected results.  */
    343      1.1     skrll       decimal_exponent += ((long) number_of_digits_before_decimal
    344      1.1     skrll 			   - (long) number_of_digits_to_use);
    345      1.1     skrll 
    346      1.1     skrll       more_than_enough_bits_for_digits
    347      1.1     skrll 	= (number_of_digits_to_use * 3321928 / 1000000 + 1);
    348      1.1     skrll 
    349      1.1     skrll       more_than_enough_littlenums_for_digits
    350      1.1     skrll 	= (more_than_enough_bits_for_digits
    351      1.1     skrll 	   / LITTLENUM_NUMBER_OF_BITS)
    352      1.1     skrll 	+ 2;
    353      1.1     skrll 
    354      1.1     skrll       /* Compute (digits) part. In "12.34E56" this is the "1234" part.
    355      1.1     skrll 	 Arithmetic is exact here. If no digits are supplied then this
    356      1.1     skrll 	 part is a 0 valued binary integer.  Allocate room to build up
    357      1.1     skrll 	 the binary number as littlenums.  We want this memory to
    358      1.1     skrll 	 disappear when we leave this function.  Assume no alignment
    359      1.1     skrll 	 problems => (room for n objects) == n * (room for 1
    360      1.1     skrll 	 object).  */
    361      1.1     skrll 
    362      1.1     skrll       size_of_digits_in_littlenums = more_than_enough_littlenums_for_digits;
    363      1.1     skrll       size_of_digits_in_chars = size_of_digits_in_littlenums
    364      1.1     skrll 	* sizeof (LITTLENUM_TYPE);
    365      1.1     skrll 
    366      1.1     skrll       digits_binary_low = (LITTLENUM_TYPE *)
    367  1.1.1.4  christos 	xmalloc (size_of_digits_in_chars);
    368      1.1     skrll 
    369      1.1     skrll       memset ((char *) digits_binary_low, '\0', size_of_digits_in_chars);
    370      1.1     skrll 
    371      1.1     skrll       /* Digits_binary_low[] is allocated and zeroed.  */
    372      1.1     skrll 
    373      1.1     skrll       /*
    374      1.1     skrll        * Parse the decimal digits as if * digits_low was in the units position.
    375      1.1     skrll        * Emit a binary number into digits_binary_low[].
    376      1.1     skrll        *
    377      1.1     skrll        * Use a large-precision version of:
    378      1.1     skrll        * (((1st-digit) * 10 + 2nd-digit) * 10 + 3rd-digit ...) * 10 + last-digit
    379      1.1     skrll        */
    380      1.1     skrll 
    381      1.1     skrll       for (p = first_digit, count = number_of_digits_to_use; count; p++, --count)
    382      1.1     skrll 	{
    383      1.1     skrll 	  c = *p;
    384      1.1     skrll 	  if (ISDIGIT (c))
    385      1.1     skrll 	    {
    386      1.1     skrll 	      /*
    387      1.1     skrll 	       * Multiply by 10. Assume can never overflow.
    388      1.1     skrll 	       * Add this digit to digits_binary_low[].
    389      1.1     skrll 	       */
    390      1.1     skrll 
    391      1.1     skrll 	      long carry;
    392      1.1     skrll 	      LITTLENUM_TYPE *littlenum_pointer;
    393      1.1     skrll 	      LITTLENUM_TYPE *littlenum_limit;
    394      1.1     skrll 
    395      1.1     skrll 	      littlenum_limit = digits_binary_low
    396      1.1     skrll 		+ more_than_enough_littlenums_for_digits
    397      1.1     skrll 		- 1;
    398      1.1     skrll 
    399      1.1     skrll 	      carry = c - '0';	/* char -> binary */
    400      1.1     skrll 
    401      1.1     skrll 	      for (littlenum_pointer = digits_binary_low;
    402      1.1     skrll 		   littlenum_pointer <= littlenum_limit;
    403      1.1     skrll 		   littlenum_pointer++)
    404      1.1     skrll 		{
    405      1.1     skrll 		  long work;
    406      1.1     skrll 
    407      1.1     skrll 		  work = carry + 10 * (long) (*littlenum_pointer);
    408      1.1     skrll 		  *littlenum_pointer = work & LITTLENUM_MASK;
    409      1.1     skrll 		  carry = work >> LITTLENUM_NUMBER_OF_BITS;
    410      1.1     skrll 		}
    411      1.1     skrll 
    412      1.1     skrll 	      if (carry != 0)
    413      1.1     skrll 		{
    414      1.1     skrll 		  /*
    415      1.1     skrll 		   * We have a GROSS internal error.
    416      1.1     skrll 		   * This should never happen.
    417      1.1     skrll 		   */
    418      1.1     skrll 		  as_fatal (_("failed sanity check"));
    419      1.1     skrll 		}
    420      1.1     skrll 	    }
    421      1.1     skrll 	  else
    422      1.1     skrll 	    {
    423      1.1     skrll 	      ++count;		/* '.' doesn't alter digits used count.  */
    424      1.1     skrll 	    }
    425      1.1     skrll 	}
    426      1.1     skrll 
    427      1.1     skrll       /*
    428      1.1     skrll        * Digits_binary_low[] properly encodes the value of the digits.
    429      1.1     skrll        * Forget about any high-order littlenums that are 0.
    430      1.1     skrll        */
    431      1.1     skrll       while (digits_binary_low[size_of_digits_in_littlenums - 1] == 0
    432      1.1     skrll 	     && size_of_digits_in_littlenums >= 2)
    433      1.1     skrll 	size_of_digits_in_littlenums--;
    434      1.1     skrll 
    435      1.1     skrll       digits_flonum.low = digits_binary_low;
    436      1.1     skrll       digits_flonum.high = digits_binary_low + size_of_digits_in_littlenums - 1;
    437      1.1     skrll       digits_flonum.leader = digits_flonum.high;
    438      1.1     skrll       digits_flonum.exponent = 0;
    439      1.1     skrll       /*
    440      1.1     skrll        * The value of digits_flonum . sign should not be important.
    441      1.1     skrll        * We have already decided the output's sign.
    442      1.1     skrll        * We trust that the sign won't influence the other parts of the number!
    443      1.1     skrll        * So we give it a value for these reasons:
    444      1.1     skrll        * (1) courtesy to humans reading/debugging
    445      1.1     skrll        *     these numbers so they don't get excited about strange values
    446      1.1     skrll        * (2) in future there may be more meaning attached to sign,
    447      1.1     skrll        *     and what was
    448      1.1     skrll        *     harmless noise may become disruptive, ill-conditioned (or worse)
    449      1.1     skrll        *     input.
    450      1.1     skrll        */
    451      1.1     skrll       digits_flonum.sign = '+';
    452      1.1     skrll 
    453      1.1     skrll       {
    454      1.1     skrll 	/*
    455  1.1.1.5  christos 	 * Compute the mantissa (& exponent) of the power of 10.
    456      1.1     skrll 	 * If successful, then multiply the power of 10 by the digits
    457      1.1     skrll 	 * giving return_binary_mantissa and return_binary_exponent.
    458      1.1     skrll 	 */
    459      1.1     skrll 
    460      1.1     skrll 	int decimal_exponent_is_negative;
    461      1.1     skrll 	/* This refers to the "-56" in "12.34E-56".  */
    462      1.1     skrll 	/* FALSE: decimal_exponent is positive (or 0) */
    463      1.1     skrll 	/* TRUE:  decimal_exponent is negative */
    464      1.1     skrll 	FLONUM_TYPE temporary_flonum;
    465      1.1     skrll 	unsigned int size_of_power_in_littlenums;
    466      1.1     skrll 	unsigned int size_of_power_in_chars;
    467      1.1     skrll 
    468      1.1     skrll 	size_of_power_in_littlenums = precision;
    469      1.1     skrll 	/* Precision has a built-in fudge factor so we get a few guard bits.  */
    470      1.1     skrll 
    471      1.1     skrll 	decimal_exponent_is_negative = decimal_exponent < 0;
    472      1.1     skrll 	if (decimal_exponent_is_negative)
    473      1.1     skrll 	  {
    474      1.1     skrll 	    decimal_exponent = -decimal_exponent;
    475      1.1     skrll 	  }
    476      1.1     skrll 
    477      1.1     skrll 	/* From now on: the decimal exponent is > 0. Its sign is separate.  */
    478      1.1     skrll 
    479      1.1     skrll 	size_of_power_in_chars = size_of_power_in_littlenums
    480      1.1     skrll 	  * sizeof (LITTLENUM_TYPE) + 2;
    481      1.1     skrll 
    482  1.1.1.4  christos 	power_binary_low = (LITTLENUM_TYPE *) xmalloc (size_of_power_in_chars);
    483  1.1.1.4  christos 	temporary_binary_low = (LITTLENUM_TYPE *) xmalloc (size_of_power_in_chars);
    484  1.1.1.4  christos 
    485      1.1     skrll 	memset ((char *) power_binary_low, '\0', size_of_power_in_chars);
    486      1.1     skrll 	*power_binary_low = 1;
    487      1.1     skrll 	power_of_10_flonum.exponent = 0;
    488      1.1     skrll 	power_of_10_flonum.low = power_binary_low;
    489      1.1     skrll 	power_of_10_flonum.leader = power_binary_low;
    490      1.1     skrll 	power_of_10_flonum.high = power_binary_low + size_of_power_in_littlenums - 1;
    491      1.1     skrll 	power_of_10_flonum.sign = '+';
    492      1.1     skrll 	temporary_flonum.low = temporary_binary_low;
    493      1.1     skrll 	temporary_flonum.high = temporary_binary_low + size_of_power_in_littlenums - 1;
    494      1.1     skrll 	/*
    495      1.1     skrll 	 * (power) == 1.
    496      1.1     skrll 	 * Space for temporary_flonum allocated.
    497      1.1     skrll 	 */
    498      1.1     skrll 
    499      1.1     skrll 	/*
    500      1.1     skrll 	 * ...
    501      1.1     skrll 	 *
    502      1.1     skrll 	 * WHILE	more bits
    503      1.1     skrll 	 * DO	find next bit (with place value)
    504      1.1     skrll 	 *	multiply into power mantissa
    505      1.1     skrll 	 * OD
    506      1.1     skrll 	 */
    507      1.1     skrll 	{
    508      1.1     skrll 	  int place_number_limit;
    509      1.1     skrll 	  /* Any 10^(2^n) whose "n" exceeds this */
    510      1.1     skrll 	  /* value will fall off the end of */
    511      1.1     skrll 	  /* flonum_XXXX_powers_of_ten[].  */
    512      1.1     skrll 	  int place_number;
    513      1.1     skrll 	  const FLONUM_TYPE *multiplicand;	/* -> 10^(2^n) */
    514      1.1     skrll 
    515      1.1     skrll 	  place_number_limit = table_size_of_flonum_powers_of_ten;
    516      1.1     skrll 
    517      1.1     skrll 	  multiplicand = (decimal_exponent_is_negative
    518      1.1     skrll 			  ? flonum_negative_powers_of_ten
    519      1.1     skrll 			  : flonum_positive_powers_of_ten);
    520      1.1     skrll 
    521      1.1     skrll 	  for (place_number = 1;/* Place value of this bit of exponent.  */
    522      1.1     skrll 	       decimal_exponent;/* Quit when no more 1 bits in exponent.  */
    523      1.1     skrll 	       decimal_exponent >>= 1, place_number++)
    524      1.1     skrll 	    {
    525      1.1     skrll 	      if (decimal_exponent & 1)
    526      1.1     skrll 		{
    527      1.1     skrll 		  if (place_number > place_number_limit)
    528      1.1     skrll 		    {
    529      1.1     skrll 		      /* The decimal exponent has a magnitude so great
    530      1.1     skrll 			 that our tables can't help us fragment it.
    531      1.1     skrll 			 Although this routine is in error because it
    532      1.1     skrll 			 can't imagine a number that big, signal an
    533      1.1     skrll 			 error as if it is the user's fault for
    534      1.1     skrll 			 presenting such a big number.  */
    535      1.1     skrll 		      return_value = ERROR_EXPONENT_OVERFLOW;
    536      1.1     skrll 		      /* quit out of loop gracefully */
    537      1.1     skrll 		      decimal_exponent = 0;
    538      1.1     skrll 		    }
    539      1.1     skrll 		  else
    540      1.1     skrll 		    {
    541      1.1     skrll #ifdef TRACE
    542      1.1     skrll 		      printf ("before multiply, place_number = %d., power_of_10_flonum:\n",
    543      1.1     skrll 			      place_number);
    544      1.1     skrll 
    545      1.1     skrll 		      flonum_print (&power_of_10_flonum);
    546      1.1     skrll 		      (void) putchar ('\n');
    547      1.1     skrll #endif
    548      1.1     skrll #ifdef TRACE
    549      1.1     skrll 		      printf ("multiplier:\n");
    550      1.1     skrll 		      flonum_print (multiplicand + place_number);
    551      1.1     skrll 		      (void) putchar ('\n');
    552      1.1     skrll #endif
    553      1.1     skrll 		      flonum_multip (multiplicand + place_number,
    554      1.1     skrll 				     &power_of_10_flonum, &temporary_flonum);
    555      1.1     skrll #ifdef TRACE
    556      1.1     skrll 		      printf ("after multiply:\n");
    557      1.1     skrll 		      flonum_print (&temporary_flonum);
    558      1.1     skrll 		      (void) putchar ('\n');
    559      1.1     skrll #endif
    560      1.1     skrll 		      flonum_copy (&temporary_flonum, &power_of_10_flonum);
    561      1.1     skrll #ifdef TRACE
    562      1.1     skrll 		      printf ("after copy:\n");
    563      1.1     skrll 		      flonum_print (&power_of_10_flonum);
    564      1.1     skrll 		      (void) putchar ('\n');
    565      1.1     skrll #endif
    566      1.1     skrll 		    } /* If this bit of decimal_exponent was computable.*/
    567      1.1     skrll 		} /* If this bit of decimal_exponent was set.  */
    568      1.1     skrll 	    } /* For each bit of binary representation of exponent */
    569      1.1     skrll #ifdef TRACE
    570      1.1     skrll 	  printf ("after computing power_of_10_flonum:\n");
    571      1.1     skrll 	  flonum_print (&power_of_10_flonum);
    572      1.1     skrll 	  (void) putchar ('\n');
    573      1.1     skrll #endif
    574      1.1     skrll 	}
    575      1.1     skrll       }
    576      1.1     skrll 
    577      1.1     skrll       /*
    578      1.1     skrll        * power_of_10_flonum is power of ten in binary (mantissa) , (exponent).
    579      1.1     skrll        * It may be the number 1, in which case we don't NEED to multiply.
    580      1.1     skrll        *
    581      1.1     skrll        * Multiply (decimal digits) by power_of_10_flonum.
    582      1.1     skrll        */
    583      1.1     skrll 
    584      1.1     skrll       flonum_multip (&power_of_10_flonum, &digits_flonum, address_of_generic_floating_point_number);
    585      1.1     skrll       /* Assert sign of the number we made is '+'.  */
    586      1.1     skrll       address_of_generic_floating_point_number->sign = digits_sign_char;
    587      1.1     skrll 
    588  1.1.1.4  christos       if (temporary_binary_low)
    589  1.1.1.4  christos 	free (temporary_binary_low);
    590  1.1.1.4  christos       if (power_binary_low)
    591  1.1.1.4  christos 	free (power_binary_low);
    592  1.1.1.4  christos       free (digits_binary_low);
    593      1.1     skrll     }
    594      1.1     skrll   return return_value;
    595      1.1     skrll }
    596      1.1     skrll 
    597      1.1     skrll #ifdef TRACE
    598      1.1     skrll static void
    599      1.1     skrll flonum_print (f)
    600      1.1     skrll      const FLONUM_TYPE *f;
    601      1.1     skrll {
    602      1.1     skrll   LITTLENUM_TYPE *lp;
    603      1.1     skrll   char littlenum_format[10];
    604      1.1     skrll   sprintf (littlenum_format, " %%0%dx", sizeof (LITTLENUM_TYPE) * 2);
    605      1.1     skrll #define print_littlenum(LP)	(printf (littlenum_format, LP))
    606      1.1     skrll   printf ("flonum @%p %c e%ld", f, f->sign, f->exponent);
    607      1.1     skrll   if (f->low < f->high)
    608      1.1     skrll     for (lp = f->high; lp >= f->low; lp--)
    609      1.1     skrll       print_littlenum (*lp);
    610      1.1     skrll   else
    611      1.1     skrll     for (lp = f->low; lp <= f->high; lp++)
    612      1.1     skrll       print_littlenum (*lp);
    613      1.1     skrll   printf ("\n");
    614      1.1     skrll   fflush (stdout);
    615      1.1     skrll }
    616      1.1     skrll #endif
    617      1.1     skrll 
    618      1.1     skrll /* end of atof_generic.c */
    619