ATOI(3)

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

SKŁADNIA
#include <stdlib.h>

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

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

atoll():
    _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
    lub cc -std=c99

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. atoq() jest przestarzałą nazwą dla atoll().

WARTOŚĆ ZWRACANA
Zwracany jest wynik przekształcenia.

ZGODNE Z
SVr4, POSIX.1-2001, 4.3BSD, C99. C89 and POSIX.1-1996 zawierają tylko funkcje atoi() i atol(). atoq() jest rozszerzeniem GNU.

UWAGI
Niestandardowa funkcja atoq() nie występuje w libc 4.6.27 i glibc 2, ale jest obecna w libc5 i libc 4.7 (chociaż tylko jako funkcja włączana (inline) w <stdlib.h> aż do libc 5.4.44). Funkcja atoll() występuje w glibc 2 od wersji 2.0.2, ale ma jej w libc4 i libc5.

ZOBACZ TAKŻE
atof(3), strtod(3), strtol(3), strtoul(3)

O STRONIE
Angielska wersja tej strony pochodzi z wydania 3.52 projektu Linux man-pages. Opis projektu oraz informacje dotyczące zgłaszania błędów można znaleźć pod adresem http://www.kernel.org/doc/man-pages/.

TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika man są: Adam Byrtek (PTM) <abyrtek@priv.onet.pl> i Robert Luberda <robert@debian.org>.

Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją 3.52 oryginału.