ATOI(3)                   OpenBSD Programmer's Manual                  ATOI(3)

NAME
     atoi - convert ASCII string to integer

SYNOPSIS
     #include <stdlib.h>

     int
     atoi(const char *nptr);

DESCRIPTION
     The atoi() function converts the initial portion of the string pointed to
     by nptr to integer representation.

     It is equivalent to:

           (int)strtol(nptr, (char **)NULL, 10);

SEE ALSO
     atof(3), atol(3), strtod(3), strtol(3), strtonum(3), strtoul(3)

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

CAVEATS
     atoi does no overflow checking, handles unsigned numbers poorly, and han-
     dles strings containing trailing extra characters (like ``123abc'') poor-
     ly.  Careful use of strtol(3) and strtoul(3) can alleviate these prob-
     lems, but strtonum(3) can be used to convert numbers from strings much
     more safely and easily.

OpenBSD 4.0                      June 4, 1993                                1
