logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

atoi, atol, atoll - convert a string to an integer

Attributes

       For an explanation of the terms used in this section, see attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬───────────────┬────────────────┐
       │ InterfaceAttributeValue          │
       ├──────────────────────────────────────────────────────────────────────┼───────────────┼────────────────┤
       │ atoi(), atol(), atoll()                                              │ Thread safety │ MT-Safe locale │
       └──────────────────────────────────────────────────────────────────────┴───────────────┴────────────────┘

Bugs

errno is not set on error so there is no way to distinguish between 0 as an error and  as  the  converted
       value.   No  checks  for  overflow  or  underflow  are done.  Only base-10 input can be converted.  It is
       recommended to instead use the strtol() and strtoul() family of functions in new programs.

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 longlong.

History

       C99, POSIX.1-2001, SVr4, 4.3BSD.

       C89 and POSIX.1-1996 include the functions atoi() and atol() only.

Library

       Standard C library (libc, -lc)

Name

       atoi, atol, atoll - convert a string to an integer

Return Value

       The converted value or 0 on error.

See Also

atof(3), strtod(3), strtol(3), strtoul(3)

Linux man-pages 6.9.1                              2024-05-02                                            atoi(3)

Standards

       C11, POSIX.1-2008.

Synopsis

#include<stdlib.h>intatoi(constchar*nptr);longatol(constchar*nptr);longlongatoll(constchar*nptr);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       atoll():
           _ISOC99_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

Versions

       POSIX.1  leaves  the  return value of atoi() on error unspecified.  On glibc, musl libc, and uClibc, 0 is
       returned on error.

return

See Also