Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
ATOL(3)		       FreeBSD Library Functions Manual		       ATOL(3)

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

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <stdlib.h>

     long
     atol(const	char *nptr);

     long long
     atoll(const char *nptr);

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);

COMPATIBILITY
     The FreeBSD implementations of the	atol() and atoll() functions are thin
     wrappers around strtol() and stroll() respectively, so these functions
     will affect the value of errno in the same	way that the strtol() and
     stroll() functions	are able to.  This behavior of atol() and atoll() is
     not required by ISO/IEC 9899:1990 (``ISO C90'') or	ISO/IEC	9899:1999
     (``ISO C99''), but	it is allowed by all of	ISO/IEC	9899:1990
     (``ISO C90''), ISO/IEC 9899:1999 (``ISO C99'') and	IEEE Std 1003.1-2001
     (``POSIX.1'').

ERRORS
     The functions atol() and atoll() may 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'').

FreeBSD	9.2		       February	1, 2009			   FreeBSD 9.2

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | COMPATIBILITY | ERRORS | SEE ALSO | STANDARDS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=atol&sektion=3&manpath=FreeBSD+9.2-RELEASE>

home | help