atoi, _wtoi

Aus RAD Studio
Wechseln zu: Navigation, Suche

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

+