atoi, _atoi_l, _wtoi, _wtoi_l

Artikel
02/26/2013

Konvertieren einer Zeichenfolge in Integer.

int atoi(
   const char *str 
);
int _wtoi(
   const wchar_t *str 
);
int _atoi_l(
   const char *str,
   _locale_t locale
);
int _wtoi_l(
   const wchar_t *str,
   _locale_t locale
);

Parameter

str
Der zu konvertierende Zeichenfolge.
locale
Der zu verwendende Gebietsschema.

Rückgabewert

Jede Funktion gibt den Wert zurück, der int mithilfe der Eingabezeichen als Zahl erzeugt wird, interpretiert.Der Rückgabewert ist 0 für atoiund _wtoi, wenn die Eingabe nicht auf einen Wert dieses Typs konvertiert werden kann.

Im Fall des Überlaufs mit großen negativen ganzzahligen Werten, wird LONG_MIN zurückgegeben.Geben _wtoi undatoiINT_MAX und INT_MIN auf diesen Bedingungen zurück.In allen Fällen wird errno außerhalb des Gültigkeitsbereichs zu ERANGEfestgelegt.Wenn der Parameter übergebene NULLungültige Parameter ist, wird der Ereignishandler aufgerufen, wie in Parametervalidierungbeschrieben.Wenn die Ausführung fortgesetzt werden kann, darf dieses Features zu EINVAL und legen errno return 0.

Hinweise

Diese Funktion konvertieren eine Zeichenfolge in einen ganzzahligen Wert (atoi und _wtoi).Die Eingabezeichenfolge ist eine Folge von Zeichen, die als numerische Wert des angegebenen Typs interpretiert werden können.Die Funktion wird beendet, die Eingabezeichenfolge am ersten Zeichen zu lesen, das sie nicht als Teil einer Zahl erkennen kann.Dieses Zeichen ist möglicherweise das NULL-Zeichen („\ 0 " oder l " \ 0 ") die Zeichenfolge Beenden.

Das str-Argument an atoiund _wtoi verfügt über das folgende Format:

[whitespace] [sign] [digits]]

whitespace besteht aus Leerzeichen oder Tabulatorzeichen, die ignoriert werden. sign ist entweder Plus (+) oder Minuszeichen (–); und digits sind eine oder mehrere Ziffern.

Die Versionen dieser Funktionen mit dem _l Suffix sind identisch, mit der Ausnahme, dass sie verwenden den Gebietsschemaparameter, der anstelle des aktuellen Gebietsschemas übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Zuweisung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definieren	_UNICODE definiert
_tstoi	atoi	atoi	_wtoi
_ttoi	atoi	atoi	_wtoi

Anforderungen

Routinen	Erforderlicher Header
atoi	<stdlib.h>
_atoi_l, _wtoi, _wtoi_l	<stdlib.h> oder <wchar.h>

Beispiel

Dieses Programm zeigt, wie die Zahlen als Zeichenfolgen gespeichert werden, auf numerischen Werten mithilfe der atoi-Funktionen konvertiert werden können.

// crt_atoi.c
// This program shows how numbers 
// stored as strings can be converted to
// numeric values using the atoi functions.

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

int main( void )
{
    char    *str = NULL;
    int     value = 0;

    // An example of the atoi function.
    str = "  -2309 ";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function.
    str = "31412764";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );

    // Another example of the atoi function 
    // with an overflow condition occuring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}