atoi, atol, atoll

Interpretiert einen ganzzahligen Wert in der 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 Ganzzahldarstellung zu bilden, und wandelt sie in einen ganzzahligen Wert um. Der gültige ganzzahlige Wert besteht aus den folgenden Teilen:

• (optional) Plus- oder Minuszeichen
• 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

Rückgabewert

Integer-Wert entsprechend dem Inhalt von str bei Erfolg.

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

Hinweise

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

Beispiel

#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")); // behandelt als Dezimalzahl mit führenden Nullen
    printf("%i\n", atoi("0x2A")); // nur die führende Null wird konvertiert, "x2A" wird verworfen
    printf("%i\n", atoi("junk")); // keine Konvertierung kann durchgeführt werden
    printf("%i\n", atoi("2147483648")); // UB: außerhalb des Wertebereichs von int
}

-123
321
0
42
0
0
-2147483648

Referenzen

Siehe auch