home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / ixemul-39.47-env-bin.lha / man / cat3 / strtoul.0 < prev    next >
Text File  |  1993-12-07  |  3KB  |  67 lines
  1.  
  2. STRTOUL(3)                 UNIX Programmer's Manual                 STRTOUL(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrttoouull - convert a string to an unsigned long integer
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddlliibb..hh>>
  9.      ##iinncclluuddee <<lliimmiittss..hh>>
  10.  
  11.      ssttrrttoouull(_c_o_n_s_t _c_h_a_r _*_n_p_t_r, _c_h_a_r _*_*_e_n_d_p_t_r, _i_n_t _b_a_s_e)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The ssttrrttoouull() function converts the string in _n_p_t_r to an _u_n_s_i_g_n_e_d _l_o_n_g
  15.      value according to the given _b_a_s_e, which must be between 2 and 36 inclu­
  16.      sive, or be the special value 0.
  17.  
  18.      The string may begin with an arbitrary amount of white space (as deter­
  19.      mined by isspace(3))  followed by a single optional `+' or `­' sign.  If
  20.      _b_a_s_e is zero or 16, the string may then include a `0x' prefix, and the
  21.      number will be read in base 16; otherwise, a zero _b_a_s_e is taken as 10
  22.      (decimal) unless the next character is `0', in which case it is taken as
  23.      8 (octal).
  24.  
  25.      The remainder of the string is converted to an _u_n_s_i_g_n_e_d _l_o_n_g value in the
  26.      obvious manner, stopping at the end of the string or at the first charac­
  27.      ter that does not produce a valid digit in the given base.  (In bases
  28.      above 10, the letter `A' in either upper or lower case represents 10, `B'
  29.      represents 11, and so forth, with `Z' representing 35.)
  30.  
  31.      If _e_n_d_p_t_r is non nil, ssttrrttoouull() stores the address of the first invalid
  32.      character in _*_e_n_d_p_t_r. If there were no digits at all, however, ssttrrttoouull()
  33.      stores the original value of _n_p_t_r in _*_e_n_d_p_t_r. (Thus, if _*_n_p_t_r is not `\0'
  34.      but _*_*_e_n_d_p_t_r is `\0' on return, the entire string was valid.)
  35.  
  36. RREETTUURRNN VVAALLUUEESS
  37.      The ssttrrttoouull() function returns either the result of the conversion or, if
  38.      there was a leading minus sign, the negation of the result of the conver­
  39.      sion, unless the original (non­negated) value would overflow; in the lat­
  40.      ter case, ssttrrttoouull() returns ULONG_MAX and sets the global variable _e_r_r_n_o
  41.      to ERANGE.
  42.  
  43. EERRRROORRSS
  44.      [ERANGE]  The given string was out of range; the value converted has been
  45.                clamped.
  46.  
  47. SSEEEE AALLSSOO
  48.      strtol(3)
  49.  
  50. SSTTAANNDDAARRDDSS
  51.      The ssttrrttoouull() function conforms to ANSI C3.159­1989 (``ANSI C'').
  52.  
  53. BBUUGGSS
  54.      Ignores the current locale.
  55.  
  56. BSD Experimental                 June 29, 1991                               1
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.