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

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

NNAAMMEE
     ssttrrttooll,, ssttrrttooqq - convert string value to a long or quad_t integer

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

     _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 <<ssyyss//ttyyppeess..hh>>
     ##iinncclluuddee <<ssttddlliibb..hh>>
     ##iinncclluuddee <<lliimmiittss..hh>>

     _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