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