STRTOL(3) BSD Programmer's Manual STRTOL(3) NNAAMMEE ssttrrttooll,, ssttrrttooqq - convert string value to a long or quad_t integer SSYYNNOOPPSSIISS ##iinncclluuddee <> ##iinncclluuddee <> _l_o_n_g ssttrrttooll(_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 <> ##iinncclluuddee <> ##iinncclluuddee <> _q_u_a_d___t ssttrrttooqq(_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 ssttrrttooll() function converts the string in _n_p_t_r to a _l_o_n_g value. The ssttrrttooqq() function converts the string in _n_p_t_r to a _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 a _l_o_n_g value in the obvious manner, stopping at the first character which is not 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' represent- ing 35.) If _e_n_d_p_t_r is non nil, ssttrrttooll() stores the address of the first invalid character in _*_e_n_d_p_t_r. If there were no digits at all, however, ssttrrttooll() 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 ssttrrttooll() function returns the result of the conversion, unless the value would underflow or overflow. If an underflow occurs, ssttrrttooll() re- turns LONG_MIN. If an overflow occurs, ssttrrttooll() returns LONG_MAX. In both cases, _e_r_r_n_o is set to ERANGE. EERRRROORRSS [ERANGE] The given string was out of range; the value converted has been clamped. SSEEEE AALLSSOO atof(3), atoi(3), atol(3), strtod(3), strtoul(3) SSTTAANNDDAARRDDSS The ssttrrttooll() function conforms to ANSI C X3.159-1989 (``ANSI C ''). BBUUGGSS Ignores the current locale. 4.4BSD June 4, 1993 1