atoi, _wtoi
Nach oben zu Stdlib.h - Index
Header-Datei
stdlib.h
Kategorie
Konvertierungsroutinen, mathematische Routinen
Prototyp
int atoi(const char *s);
int _wtoi(const wchar_t *s);
Beschreibung
Konvertiert einen String in einen Integerwert.
- atoi konvertiert den String, auf den s zeigt, in einen Wert des Typs int; atoi erkennt (in der folgenden Reihenfolge)
- Einen optionalen String aus Tabulator- und Leerzeichen
- Ein optionales Vorzeichen
- Einen aus Ziffern bestehenden String
Die Zeichendarstellung muss diesem generischen Format entsprechen:
[Whitespace-Zeichen] [Vorzeichen] [zzz]
Die Funktion beendet die Konvertierung bei dem ersten nicht erkannten Zeichen. atoi trifft keine Vorkehrungen gegen einen Überlauf (die Ergebnisse sind nicht definiert).
Rückgabewert
atoi gibt den konvertierten Wert des Eingabe-Strings zurück. Kann der String nicht in einen Wert des entsprechenden Typs (int) konvertiert werden, gibt atoi 0 zurück.
Beispiel
#include <stdlib.h>
#include <stdio.h>
int main(void)
{
int n;
char *str = "12345.67";
n = atoi(str);
printf("string = %s integer = %d\n", str, n);
return 0;
}
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
atoi |
+ |
+ |
+ |
+ |
_wtoi |
+ |