ATOL(3)

NAME
atol, atoll, atol_l, atoll_l - convert ASCII string to long or long long integer

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
The atol() 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 isoC. The atoll() function conforms to isoC-99.