NAME
atol, atoll,
atol_l, atoll_l —
convert ASCII string to
long or long long
integer
LIBRARY
library “libc”
SYNOPSIS
#include
<stdlib.h>
long
atol(const
char *nptr);
long long
atoll(const
char *nptr);
#include
<xlocale.h>
long
atol_l(const
char *nptr, locale_t
loc);
long long
atoll_l(const
char *nptr, locale_t
loc);
DESCRIPTION
Theatol()
function converts the initial portion of the string pointed to by
nptr to long integer
representation.
It is equivalent to:
strtol(nptr, NULL, 10);The
atoll()
function converts the initial portion of the string pointed to by
nptr to long long integer
representation.
It is equivalent to:
strtoll(nptr, NULL, 10);The _l-suffixed versions take an explicit locale argument, whereas the non-suffixed versions use the current global or per-thread locale.
ERRORS
The functions atol() and
atoll() need not affect the value of
errno on an error.
SEE ALSO
atof(3), atoi(3), strtod(3), strtol(3), strtoul(3), xlocale(3)
STANDARDS
The atol() function conforms to
ISO/IEC 9899:1990 (“ISO C90”).
The atoll() function conforms to
ISO/IEC 9899:1999
(“ISO C99”).