strtol(3C)                                             strtol(3C)



     NAME
          strtol, atol, atoi - convert string 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 re-
          turned.

          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 oc-
          tal 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)


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





     April, 1990                                                     1

     strtol(3C)                                             strtol(3C)



     BUGS
          Overflow conditions are ignored.





















































     2                                                     April, 1990