.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Mon Mar 29 22:39:41 1993, David Metcalfe .\" Modified Sat Jul 24 21:38:42 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sun Dec 17 18:35:06 2000, Joseph S. Myers .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH atoi 3 "2. Mai 2024" "Linux man\-pages 6.9.1" .SH BEZEICHNUNG atoi, atol, atoll, \- konvertiert eine Zeichenkette in eine Ganzzahl .SH BIBLIOTHEK Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP) .SH ÜBERSICHT .nf \fB#include \fP .P \fBint atoi(const char *\fP\fInptr\fP\fB);\fP \fBlong atol(const char *\fP\fInptr\fP\fB);\fP \fBlong long atoll(const char *\fP\fInptr\fP\fB);\fP .fi .P .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .P \fBatoll\fP(): .nf _ISOC99_SOURCE || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH BESCHREIBUNG Die Funktion \fBatoi\fP() konvertiert eine Zeichenkette in eine Ganzzahl. Dabei ist \fInptr\fP ein Zeiger auf die Zeichenkette, die konvertiert werden soll. Die übergebene Zeichenkette wird dabei nach den ersten passenden Zeichen durchsucht und diese werden konvertiert. Die Funktion verhält sich genauso wie .P .in +4n .EX strtol(nptr, NULL, 10); .EE .in .P mit dem Unterschied, dass \fBatoi\fP() keine Fehler erkennt. .P Die Funktionen \fBatol\fP() und \fBatoll\fP() verhalten sich wie \fBatoi\fP(). Der Unterschied ist, dass sie den Anfang der Zeichenkette in ihren Rückgabewert (also \fIlong\fP oder \fIlong long\fP) konvertieren. .SH RÜCKGABEWERT Der umgewandelte Wert oder 0 bei einem Fehler. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lbx lb lb l l l. Schnittstelle Attribut Wert T{ .na .nh \fBatoi\fP(), \fBatol\fP(), \fBatoll\fP() T} Multithread\-Fähigkeit MT\-Sicher locale .TE .SH VERSIONEN POSIX.1 gibt keinen Rückgabewert von \fBatoi\fP() bei Fehlern an. Unter glibc, musl libc und uClibc wird bei Fehlern 0 zurückgegeben. .SH STANDARDS C11, POSIX.1\-2008. .SH GESCHICHTE C99, POSIX.1\-2001, SVr4, 4.3BSD. .P .\" .SH NOTES .\" Linux libc provided .\" .BR atoq () .\" as an obsolete name for .\" .BR atoll (); .\" .BR atoq () .\" is not provided by glibc. .\" The .\" .BR atoll () .\" function is present since glibc 2.0.2, but .\" not in libc4 or libc5. C89 und POSIX.1\-1996 enthalten nur die Funktionen \fBatoi\fP() und \fBatol\fP(). .SH FEHLER Bei Fehlern wird \fIerrno\fP nicht gesetzt, daher gibt es keine Möglichkeit, zwischen 0 als Fehler oder als umgewandelter Wert zu unterscheiden. Es werden keine Überprüfungen auf Über\- oder Unterlauf ausgeführt. Nur Base\-10\-Eingaben können umgewandelt werden. Es wird empfohlen, in neuen Programmen die Funktionsfamilie \fBstrtol\fP() und \fBstrtoul\fP() zu verwenden. .SH "SIEHE AUCH" \fBatof\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoul\fP(3) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt , Michael Piefel , Martin Eberhard Schauer und Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .