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