ATOI(3) | Library Functions Manual | ATOI(3) |
atoi
, atoi_l
— convert ASCII string to integer
Standard C Library (libc, -lc)
#include
<stdlib.h>
int
atoi
(const
char *str);
#include
<xlocale.h>
int
atoi_l
(const
char *str, locale_t
loc);
The
atoi
()
function converts the initial portion of the string pointed to by
str to int representation.
It is equivalent to:
(int)strtol(str, (char **)NULL, 10);
While the
atoi
()
function uses the current locale, the
atoi_l
()
function may be passed a locale directly. See
xlocale(3) for more information.
The atoi
() and
atoi_l
() functions are thread-safe and
async-cancel-safe.
The strtol
() and
strtol_l
() functions are recommended instead of
atoi
() and atoi_l
()
functions, especially in new code.
The function atoi
() need not affect the
value of errno on an error.
atof(3), atol(3), strtod(3), strtol(3), strtoul(3), xlocale(3)
The atoi
() function conforms to
IEEE Std 1003.1-1990 (“POSIX.1”),
ISO/IEC 9899:1990 (“ISO C90”),
and ISO/IEC 9899:1999
(“ISO C99”).
June 4, 1993 | macOS 14.6 |