Freigeben über


atoi, _atoi_l, _wtoi, _wtoi_l

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");
    }
}
  

.NET Framework-Entsprechung

Siehe auch

Referenz

Datenkonvertierung

Gleitkommaunterstützung

Gebietsschema

_ecvt

_fcvt

_gcvt

setlocale, _wsetlocale

_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt _atoflt_l