


      STRTOL(3C)                  (UNIX 5.0)                 STRTOL(3C)



      NAME
           strtol, atol, atoi - convert string to integer

      SYNTAX
           long strtol (str, ptr, base)
           char *str;
           char **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 str.  The string is scanned up to the
           first character inconsistent with the base.  Leading
           ``white-space'' characters are ignored.

           If the value of ptr is not (char **)NULL, a pointer to the
           character terminating the scan is returned in *ptr.  If no
           integer can be formed, *ptr is set to str, and 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, and ``0x'' or ``0X'' is ignored
           if base is 16.

           If base is zero, the string itself determines the base thus:
           After an optional leading sign, a leading zero indicates
           octal conversion, and a leading ``0x'' or ``0X'' hexadecimal
           conversion.  Otherwise, decimal conversion is used.

           Truncation from long to int can, of course, 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).

      SEE ALSO
           atof(3C), scanf(3S).

      BUGS
           Overflow conditions are ignored.






      Page 1                                         (73 A2 02MTA REV1)



