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



NAME
     strtol - convert string value to a long

SYNOPSIS
     #include <stdlib.h>
     #include <limits.h>

     long
     strtol(nptr, endptr, base)
     _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;

DESCRIPTION
     The strtol() function converts the string in _n_p_t_r to a _l_o_n_g
     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 determined 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' representing 35.)

     If _e_n_d_p_t_r is non nil, strtol() stores the address of the
     first invalid character in *_e_n_d_p_t_r . If there were no digits
     at all, however, strtol() 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.)

RETURN VALUES
     The strtol() function returns the result of the conversion,
     unless the value would underflow or overflow.  If an under-
     flow occurs, strtol() returns LONG_MIN.  If an overflow
     occurs, strtol() returns LONG_MAX.  In both cases, errno is
     set to ERANGE .

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

SEE ALSO
     atof(3), atoi(3), atol(3), strtoul(3)



Printed 11/26/99	January 12, 1996			1






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



STANDARDS
     The strtol() function conforms to ANSI C X3.159-1989 (``ANSI
     C'').

BUGS
     Ignores the current locale.

















































Printed 11/26/99	January 12, 1996			2