Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

atol(3) [v7 man page]

ATOI(3) 						     Linux Programmer's Manual							   ATOI(3)

NAME
atoi, atol, atoll - convert a string to an integer SYNOPSIS
#include <stdlib.h> int atoi(const char *nptr); long atol(const char *nptr); long long atoll(const char *nptr); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): atoll(): __ISOC99_SOURCE || || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE DESCRIPTION
The atoi() function converts the initial portion of the string pointed to by nptr to int. The behavior is the same as strtol(nptr, NULL, 10); except that atoi() does not detect errors. The atol() and atoll() functions behave the same as atoi(), except that they convert the initial portion of the string to their return type of long or long long. RETURN VALUE
The converted value. ATTRIBUTES
For an explanation of the terms used in this section, see attributes(7). +------------------------+---------------+----------------+ |Interface | Attribute | Value | +------------------------+---------------+----------------+ |atoi(), atol(), atoll() | Thread safety | MT-Safe locale | +------------------------+---------------+----------------+ CONFORMING TO
POSIX.1-2001, POSIX.1-2008, C99, SVr4, 4.3BSD. C89 and POSIX.1-1996 include the functions atoi() and atol() only. NOTES
Linux libc provided atoq() as an obsolete name for atoll(); atoq() is not provided by glibc. SEE ALSO
atof(3), strtod(3), strtol(3), strtoul(3) COLOPHON
This page is part of release 4.15 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/. GNU
2016-03-15 ATOI(3)

Check Out this Related Man Page

ATOL(3) 						   BSD Library Functions Manual 						   ATOL(3)

NAME
atol, atoll, atol_l, atoll_l -- convert ASCII string to long or long long integer LIBRARY
Standard C Library (libc, -lc) SYNOPSIS
#include <stdlib.h> long atol(const char *str); long long atoll(const char *str); #include <xlocale.h> long atol_l(const char *str, locale_t loc); long long atoll_l(const char *str, locale_t loc); DESCRIPTION
The atol() function converts the initial portion of the string pointed to by str to long integer representation. It is equivalent to: strtol(str, (char **)NULL, 10); The atoll() function converts the initial portion of the string pointed to by str to long long integer representation. It is equivalent to: strtoll(str, (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. See xlocale(3) for more information. IMPLEMENTATION NOTES
The atol(), atoll(), atol_l(), and atoll_l() functions are thread-safe and async-cancel-safe. The FreeBSD implementations of the atol() and atoll() functions are thin wrappers around strtol() and stroll() respectively, so these func- tions 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), xlocale(3) STANDARDS
The atol() function conforms to ISO/IEC 9899:1990 (``ISO C90''). The atoll() function conforms to ISO/IEC 9899:1999 (``ISO C99''). BSD
February 1, 2009 BSD
Man Page