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 strtoll() respectively, so these functions
     will affect the value of errno in the same way that the strtol() and
     strtoll() 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 11.0-PRERELEASE          May 14, 2013          FreeBSD 11.0-PRERELEASE

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

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

home | help