Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ atoi(3C) — A/UX 0.7

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ctype(3C)

scanf(3S)

strtod(3C)



     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
          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).

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

     BUGS



     Page 1                                        (last mod. 1/14/87)





     strtol(3C)                                             strtol(3C)



          Overflow conditions are ignored.






















































     Page 2                                        (last mod. 1/14/87)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026