atoll

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.

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.

See Also

atof, atoi, strtod, strtol, strtoul

Standards

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

Last Modified: 2008-09-22 19:22:37     Page Rendered: 2010-04-28 10:16:45

Page Comments