table of contents
- bookworm 1:4.18.1-1
- bookworm-backports 1:4.24.0-2~bpo12+1
- testing 1:4.24.0-2
- unstable 1:4.24.0-2
atoi(3) | Library Functions Manual | atoi(3) |
NAZWA¶
atoi, atol, atoll - przekształca łańcuch 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);
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¶
Zwracany jest wynik przekształcenia lub 0 w razie wystąpienia błędu.
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-bezpieczne locale |
STANDARDY¶
POSIX.1-2001, POSIX.1-2008, C99, SVr4, 4.3BSD.
UWAGI¶
POSIX.1 pozostawia wartość zwracaną z atoi() w przypadku błędu nieokreśloną. W glibc, musl libc i uClibc, przy błędzie zwracane jest 0.
USTERKI¶
errno nie jest ustawiana w przypadku błędu, dlatego nie da się rozróżnić 0 jako błędu i jako wyniku przekształcenia. Nie są dokonywane sprawdzenia pod kątem przepełnienia lub niedomiaru. Konwersji podlega tylko wejście w systemie dziesiętnym. W nowych programach, zaleca się w zamian korzystać z rodziny funkcji strtol() i strtoul().
ZOBACZ TAKŻE¶
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 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.
5 lutego 2023 r. | Linux man-pages 6.03 |