atoi, atol, atoll

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte Byte-Strings

Funktionen
Zeichenmanipulation
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
Konvertierungen zu und von numerischen Formaten
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtouimax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
Stringmanipulation
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
Stringuntersuchung
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
Speichermanipulation
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
Sonstiges
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

Definiert im Header <stdlib.h>
int       atoi ( const char* str );	(1)
long      atol ( const char* str );	(2)
long long atoll( const char* str );	(3)	(seit C99)

Interpretiert einen ganzzahligen Wert in einer Byte-Zeichenkette, auf die str zeigt. Die implizite Basis ist immer 10.

Verwirft alle Leerzeichen, bis das erste Nicht-Leerzeichen gefunden wird, nimmt dann so viele Zeichen wie möglich, um eine gültige Ganzzahl darstellung zu bilden, und wandelt sie in einen ganzzahligen Wert um. Der gültige ganzzahlige Wert besteht aus den folgenden Teilen

• (optional) Vorzeichen (+ oder -)
• numerische Ziffern

Wenn der Wert des Ergebnisses nicht dargestellt werden kann, d.h. der konvertierte Wert außerhalb des Bereichs des entsprechenden Rückgabetyps liegt, ist das Verhalten undefiniert.

Parameter

str

-

Zeiger auf die nullterminierte Byte-Zeichenkette, die interpretiert werden soll

Rückgabewert

Ganzzahliger Wert, der dem Inhalt von str bei Erfolg entspricht.

Wenn keine Konvertierung durchgeführt werden kann, wird ​0​ zurückgegeben.

Notizen

Der Name steht für „ASCII zu Ganzzahl“.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    printf("%i\n", atoi(" -123junk"));
    printf("%i\n", atoi(" +321dust"));
    printf("%i\n", atoi("0"));
    printf("%i\n", atoi("0042")); // treated as a decimal number with leading zeros
    printf("%i\n", atoi("0x2A")); // only leading zero is converted discarding "x2A"
    printf("%i\n", atoi("junk")); // no conversion can be performed
    printf("%i\n", atoi("2147483648")); // UB: out of range of int
}

Mögliche Ausgabe

-123
321
0
42
0
0
-2147483648

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.22.1.2 Die Funktionen atoi, atol und atoll (S. TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.22.1.2 Die Funktionen atoi, atol und atoll (S. 249)

• C11-Standard (ISO/IEC 9899:2011)

• 7.22.1.2 Die Funktionen atoi, atol und atoll (S. 341)

• C99-Standard (ISO/IEC 9899:1999)

• 7.20.1.2 Die Funktionen atoi, atol und atoll (S. 307)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.10.1.2 Die Funktion atoi

• 4.10.1.3 Die Funktion atol

Siehe auch

strtolstrtoll (C99)	konvertiert einen Byte-String in einen Ganzzahlwert (Funktion)
strtoul strtoull (C99)	konvertiert einen Byte-String in einen vorzeichenlosen Ganzzahlwert (Funktion)
wcstolwcstoll (C95)(C99)	wandelt eine breite Zeichenkette in einen ganzzahligen Wert um (Funktion)
wcstoulwcstoull (C95)(C99)	wandelt eine breite Zeichenkette in einen vorzeichenlosen ganzzahligen Wert um (Funktion)
C++-Dokumentation für atoi, atol, atoll