atoi(3) Library Functions Manual atoi(3) BEZEICHNUNG atoi, atol, atoll, - konvertiert eine Zeichenkette in eine Ganzzahl BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int atoi(const char *nptr); long atol(const char *nptr); long long atoll(const char *nptr); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): atoll(): _ISOC99_SOURCE || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE BESCHREIBUNG Die Funktion atoi() konvertiert eine Zeichenkette in eine Ganzzahl. Dabei ist nptr ein Zeiger auf die Zeichenkette, die konvertiert werden soll. Die ubergebene Zeichenkette wird dabei nach den ersten passenden Zeichen durchsucht und diese werden konvertiert. Die Funktion verhalt sich genauso wie strtol(nptr, NULL, 10); mit dem Unterschied, dass atoi() keine Fehler erkennt. Die Funktionen atol() und atoll() verhalten sich wie atoi(). Der Unterschied ist, dass sie den Anfang der Zeichenkette in ihren Ruckgabewert (also long oder long long) konvertieren. RUCKGABEWERT Der umgewandelte Wert oder 0 bei einem Fehler. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-------------------------+-------------------------+------------------+ |Schnittstelle | Attribut | Wert | +-------------------------+-------------------------+------------------+ |atoi(), atol(), atoll() | Multithread-Fahigkeit | MT-Sicher locale | +-------------------------+-------------------------+------------------+ VERSIONEN POSIX.1 gibt keinen Ruckgabewert von atoi() bei Fehlern an. Unter glibc, musl libc und uClibc wird bei Fehlern 0 zuruckgegeben. STANDARDS C11, POSIX.1-2008. GESCHICHTE C99, POSIX.1-2001, SVr4, 4.3BSD. C89 und POSIX.1-1996 enthalten nur die Funktionen atoi() und atol(). FEHLER Bei Fehlern wird errno nicht gesetzt, daher gibt es keine Moglichkeit, zwischen 0 als Fehler oder als umgewandelter Wert zu unterscheiden. Es werden keine Uberprufungen auf Uber- oder Unterlauf ausgefuhrt. Nur Base-10-Eingaben konnen umgewandelt werden. Es wird empfohlen, in neuen Programmen die Funktionsfamilie strtol() und strtoul() zu verwenden. SIEHE AUCH atof(3), strtod(3), strtol(3), strtoul(3) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Markus Schmitt , Michael Piefel , Martin Eberhard Schauer und Mario Blattermann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 atoi(3)