Scroll to navigation

atoi(3) Library Functions Manual atoi(3)

JMÉNO

atoi, atol, atoll - převádí řetězec na číslo typu integer

KNIHOVNA

Standardní knihovna C (libc, -lc)

POUŽITÍ

#include <stdlib.h>
int atoi(const char *nptr);
long atol(const char *nptr);
long long atoll(const char *nptr);

Požaduje množinu testovacích maker pro glibc (viz feature_test_macros(7)):

atoll():


_ISOC99_SOURCE
|| /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

POPIS

Funkce atoi() převádí úvodní část řetězce nptr na číslo typu integer. Její chování je totožné s funkcí


strtol(nptr, NULL, 10);

kromě toho, že atoi() nedetekuje žádné chyby.

Funkce atol() a atoll() se chovají stejně jako atoi(), pouze převádí úvodní část řetězce na typ long případně long long.

NÁVRATOVÉ HODNOTY

The converted value or 0 on error.

ATRIBUTY

Vysvětlení pojmů použitých v této části viz attributes(7).

Rozhraní Atribut Hodnota
atoi(), atol(), atoll() Thread safety MT-Safe locale

VERZE

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

STANDARDY

C11, POSIX.1-2008.

HISTORIE

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

C89 a POSIX.1-1996 zahrnují funkce atoi() a atol().

CHYBY

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.

DALŠÍ INFORMACE

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

PŘEKLAD

Překlad této příručky do češtiny vytvořili Pavel Heimlich <tropikhajma@gmail.com>

Tento překlad je bezplatná dokumentace; Přečtěte si GNU General Public License Version 3 nebo novější ohledně podmínek autorských práv. Neexistuje ŽÁDNÁ ODPOVĚDNOST.

Pokud narazíte na nějaké chyby v překladu této příručky, pošlete e-mail na adresu translation-team-cs@lists.sourceforge.net.

2. května 2024 Linux man-pages (unreleased)