4.4BSD/usr/share/man/cat3/strtouq.0

STRTOUL(3)                  BSD Programmer's Manual                 STRTOUL(3)

NNAAMMEE
     ssttrrttoouull,, ssttrrttoouuqq - convert a string to an unsigned long or uquad_t

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssttddlliibb..hh>>
     ##iinncclluuddee <<lliimmiittss..hh>>

     _u_n_s_i_g_n_e_d _l_o_n_g
     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);


     ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
     ##iinncclluuddee <<ssttddlliibb..hh>>
     ##iinncclluuddee <<lliimmiittss..hh>>

     _u___q_u_a_d___t
     ssttrrttoouuqq(_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);

DDEESSCCRRIIPPTTIIOONN
     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
     value.  The ssttrrttoouuqq() function converts the string in _n_p_t_r to a _u___q_u_a_d___t
     value.  The conversion is done according to the given _b_a_s_e, which must be
     between 2 and 36 inclusive, or be the special value 0.

     The string may begin with an arbitrary amount of white space (as deter-
     mined by isspace(3))  followed by a single optional `+' or `-' sign.  If
     _b_a_s_e is zero or 16, the string may then include a `0x' prefix, and the
     number will be read in base 16; otherwise, a zero _b_a_s_e is taken as 10
     (decimal) unless the next character is `0', in which case it is taken as
     8 (octal).

     The remainder of the string is converted to an _u_n_s_i_g_n_e_d _l_o_n_g value in the
     obvious manner, stopping at the end of the string or at the first charac-
     ter that does not produce a valid digit in the given base.  (In bases
     above 10, the letter `A' in either upper or lower case represents 10, `B'
     represents 11, and so forth, with `Z' representing 35.)

     If _e_n_d_p_t_r is non nil, ssttrrttoouull() stores the address of the first invalid
     character in _*_e_n_d_p_t_r. If there were no digits at all, however, ssttrrttoouull()
     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'
     but _*_*_e_n_d_p_t_r is `\0' on return, the entire string was valid.)

RREETTUURRNN VVAALLUUEESS
     The ssttrrttoouull() function returns either the result of the conversion or, if
     there was a leading minus sign, the negation of the result of the conver-
     sion, unless the original (non-negated) value would overflow; in the lat-
     ter case, ssttrrttoouull() returns ULONG_MAX and sets the global variable _e_r_r_n_o
     to ERANGE.

EERRRROORRSS
     [ERANGE]  The given string was out of range; the value converted has been
               clamped.

SSEEEE AALLSSOO
     strtol(3)

SSTTAANNDDAARRDDSS
     The ssttrrttoouull() function conforms to ANSI C X3.159-1989 (``ANSI C '').

BBUUGGSS
     Ignores the current locale.

4.4BSD                           June 4, 1993                                1