NAZWA

       atoi, atol, atoll - przekształcenie łańcucha znaków na liczbę całkowitą

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

SKŁADNIA

       #include <stdlib.h>

       int atoi(const char *nptr);
       long atol(const char *nptr);
       long long atoll(const char *nptr);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

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

OPIS

       Funkcja  atoi()  przekształca  początkową część łańcucha znaków wskazywanego przez nptr na
       int. Działa tak samo, jak

           strtol(nptr, NULL, 10);

       z wyjątkiem tego, że atoi() nie wykrywa błędów.

       Funkcje  atol()  i  atoll()  zachowują  się  tak  samo,  jak  atoi(),  oprócz   tego,   że
       przekształcają  początkową  część  przekazanego  im  łańcucha  na  —  w zależności od typu
       zwracanego przez te funkcje — odpowiednio long oraz long long.

WARTOŚĆ ZWRACANA

       The converted value or 0 on error.

ATRYBUTY

       Informacje  o  pojęciach  używanych  w  tym  rozdziale   można   znaleźć   w   podręczniku
       attributes(7).

       ┌───────────────────────────────────────────────┬────────────────────────┬────────────────┐
       │Interfejs                                      │ Atrybut                │ Wartość        │
       ├───────────────────────────────────────────────┼────────────────────────┼────────────────┤
       │atoi(), atol(), atoll()                        │ Bezpieczeństwo wątkowe │ MT-Safe locale │
       └───────────────────────────────────────────────┴────────────────────────┴────────────────┘

STANDARDY

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

UWAGI

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

BŁĘDY

       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.

ZOBACZ TAKŻE

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

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej   strony   podręcznika   są:  Adam  Byrtek
       <alpha@irc.pl>,     Robert     Luberda     <robert@debian.org>     i     Michał     Kułach
       <michal.kulach@gmail.com>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją. Bliższe informacje o warunkach licencji
       można   uzyskać   zapoznając   się   z   GNU   General   Public   License   w   wersji   3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   lub   nowszej.   Nie  przyjmuje  się  ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy w tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej
       ⟨manpages-pl-list@lists.sourceforge.net⟩.