home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat3 / strtod.0 < prev    next >
Text File  |  1993-12-07  |  2KB  |  67 lines
  1.  
  2. STRTOD(3)                  UNIX Programmer's Manual                  STRTOD(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrttoodd - convert ASCII string to double
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddlliibb..hh>>
  9.  
  10.      _d_o_u_b_l_e
  11.      ssttrrttoodd(_c_o_n_s_t _c_h_a_r _*_n_p_t_r, _c_h_a_r _*_*_e_n_d_p_t_r)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The ssttrrttoodd() function converts the initial portion of the string pointed
  15.      to by _n_p_t_r to _d_o_u_b_l_e representation.
  16.  
  17.      The expected form of the string is an optional plus (``+'') or minus sign
  18.      (``­'') followed by a sequence of digits optionally containing a decimal­
  19.      point character, optionally followed by an exponent.  An exponent con­
  20.      sists of an ``E'' or ``e'', followed by an optional plus or minus sign,
  21.      followed by a sequence of digits.
  22.  
  23.      Leading white­space characters in the string (as defined by the iss­
  24.      pace(3) function) are skipped.
  25.  
  26. RREETTUURRNN VVAALLUUEESS
  27.      The ssttrrttoodd() function returns the converted value, if any.
  28.  
  29.      If _e_n_d_p_t_r is not NULL, a pointer to the character after the last charac­
  30.      ter used in the conversion is stored in the location referenced by
  31.      _e_n_d_p_t_r.
  32.  
  33.      If no conversion is performed, zero is returned and the value of _n_p_t_r is
  34.      stored in the location referenced by _e_n_d_p_t_r.
  35.  
  36.      If the correct value would cause overflow, plus or minus HUGE_VAL is re­
  37.      turned (according to the sign of the value), and ERANGE is stored in
  38.      _e_r_r_n_o. If the correct value would cause underflow, zero is returned and
  39.      ERANGE is stored in _e_r_r_n_o.
  40.  
  41. EERRRROORRSS
  42.      [ERANGE]  Overflow or underflow occurred.
  43.  
  44. SSEEEE AALLSSOO
  45.      atof(3),  atoi(3),  atol(3),  strtol(3),  strtoul(3)
  46.  
  47. SSTTAANNDDAARRDDSS
  48.      The ssttrrttoodd() function conforms to ANSI C3.159­1989 (``ANSI C'').
  49.  
  50. BBUUGGSS
  51.      This manual page represents intent instead of actual practice.  The
  52.      ssttrrttoodd() function is not currently available.
  53.  
  54. BSD Experimental                 June 29, 1991                               1
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.