atol
convert <span class="Tn">ASCII</span> string to <span class="Vt">long</span> or <span class="Vt">long long</span> integer
You're viewing an older version of this page (#3230). View the current version.
NAME
atol, atoll, atol_l, atoll_l
INTERFACE
#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, (char **)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, (char **)NULL, 10);While the atol() and atoll() functions use the current locale, the atol_l and atoll_l functions may be passed locales directly.
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)
STANDARDS
The atol() function conforms to ISO/IEC 9899:1990 (``ISO C90''). The atoll() function conforms to ISO/IEC 9899:1999 (``ISO C99'').