strtol(3C)                                             strtol(3C)



NAME
     strtol, atol, atoi - convert strings to integer

SYNOPSIS
     long strtol(str, ptr, base)
     char *str, **ptr;
     int base;

     long atol(str)
     char *str;

     int atoi(str)
     char *str;

DESCRIPTION
     strtol returns as a long integer the value represented by
     the character string pointed to by str.  The string is
     scanned up to the first character inconsistent with the
     base.  Leading white-space characters (blanks and tabs) are
     ignored.

     If the value of ptr is not (char **)NULL, a pointer to the
     character terminating the scan is returned in the location
     pointed to by ptr.  If no integer can be formed, zero is
     returned.

     If base is positive (and not greater than 36), it is used as
     the base for conversion.  After an optional leading sign,
     leading zeros are ignored; a leading 0x or 0X is ignored if
     base is 16.

     If base is zero, the string itself determines the base.
     After an optional leading sign, a leading zero indicates
     octal conversion and a leading 0x or 0X indicates
     hexadecimal conversion; otherwise, decimal conversion is
     used.

     Truncation from long to int can take place upon assignment
     or by an explicit cast.

     atol(str) is equivalent to:

        strtol(str, (char **)NULL, 10)

     atoi(str) is equivalent to:

        (int)strtol(str, (char **)NULL, 10)


LIMITATIONS
     Overflow conditions are ignored.




January 1992                                                    1

strtol(3C)                                             strtol(3C)



SEE ALSO
     ctype(3C), scanf(3S), strtod(3C)





















































2                                                    January 1992