I have forgotten
my Password

Or login with:

  • Facebookhttp://facebook.com/
  • Googlehttps://www.google.com/accounts/o8/id
  • Yahoohttps://me.yahoo.com
ComputingCStdlib.h

atol_l

Convert ASCII string to long or long long integer
+ View other versions (5)

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.

Example 1

#include <stdio.h>
#include <stdlib.h>
 
int main()
{
  char x[20] = "2147111222";
  long max = atol(x);
  printf("max = %ld\n", max);
  return 0;
}

Output:
max = 2147111222

Errors

The functions atol and atoll need not affect the value of errno on an error.

Standards

The atol function conforms to ISO/IEC 9899:1990 ("ISO C90"). The atoll function conforms to ISO/IEC 9899:1999 ("ISO C99").