====== atoi() ======

atoi ist definiert in der ''[[start|stdlib]]'', die in C über ''stdlib.h'', bzw. in C++ über ''cstdlib'' eingebunden wird.


===== Funktion =====

atoi konvertiert einen ASCII-String in eine (vorzeichenbehaftete) Integerzahl (ASCII to integer - atoi).

Zunächst werden sämtliche Whitespaces (Leerzeichen, Tabs) übersprungen, bis die ersten Ziffern gefunden werden. Es darf ein + bzw. - der Zahl vorangestellt sein.

Werden Zeichen gefunden, die nicht interpretiert werden können, so wird die Konvertierung abgebrochen und die bisher interpretierte Zahl zurückgegeben.

Gültige Strings wären z.B. " 123", "+1232", "-42".

===== Signatur =====

<code cpp>
#include <stdlib.h>
int atoi( char const * str );</code>

**str**: der zu konvertierende String \\
\\
**Return value**: die konvertiete Zahl als vorzeichenbehafteter Integerwert

===== Bemerkungen =====

Konnte keine Zahl konvertiert werden, weil der String leer oder aus nicht interpretierbaren Zeichen bestand (z.B. "abc"), so wird 0.0 zurückgegeben.
Ist die zu konvertierende Zahl so groß, dass sie nicht dargestellt werden kann, so wird [[c:lib:limits:|INT_MAX]] bzw. [[c:lib:limits:|INT_MIN]] zurückgegeben.

Die Umkehrfunktion, also einen ''int''-Wert in einen ASCII-String zu konvertierten, ist über [[c:lib:stdio:sprintf()]] möglich.

===== Beispiel =====

<code cpp>
#include <stdlib.h>
#include <stdio.h>

int main( void )
{
  char const * str = "1234";
  int value;

  value = atoi( str );

  printf( "Wert des Strings \"%s\": %d\n", str, value );

  return EXIT_SUCCESS;
}
</code>
**Ausgabe**
<code>Wert des Strings "1234": 1234</code>

===== siehe auch =====

[[start|strlib]]: [[atof()]], [[atol()]], [[strtod()]], [[strtol()]], [[strtoul()]] \\
[[c:lib:stdio:start|string]]: [[c:lib:stdio:sprintf()]]