atoi, _atoi_l, _wtoi, _wtoi_l

Przekonwertuj ciąg na liczbę całkowitą.

Składnia

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

Parametry

str
Ciąg do przekonwertowania.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Każda funkcja zwraca int wartość wygenerowaną przez interpretowanie znaków wejściowych jako liczby. Wartość zwracana to 0 dla atoi wartości i _wtoi, jeśli nie można przekonwertować danych wejściowych na wartość tego typu.

Gdy funkcje przepełnią się dużymi ujemnymi wartościami całkowitymi, LONG_MIN zwracana jest wartość . atoii zwracają INT_MAX i INT_MIN_wtoi na tych warunkach. We wszystkich przypadkach errno poza zakresem ustawiono wartość ERANGE. Jeśli przekazany parametr to NULL, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonanie może kontynuować, te funkcje są ustawione errno na EINVAL wartość i zwracają wartość 0.

Uwagi

Te funkcje konwertują ciąg znaków na wartość całkowitą (atoi i _wtoi). Ciąg wejściowy to sekwencja znaków, które można interpretować jako wartość liczbową określonego typu. Funkcja zatrzymuje odczytywanie ciągu wejściowego przy pierwszym znaku, którego nie może rozpoznać jako części liczby. Ten znak może być znakiem null (\0' lub L'\0') kończącym ciąg.

Argument str do atoi i _wtoi ma następującą formę:

[] [whitespacesign] [] [digits]

Element whitespace składa się z spacji lub znaków tabulacji, które są ignorowane; sign jest znakiem plus (+) lub minus (-) i digits są co najmniej jedną cyfrą.

Wersje tych funkcji z sufiksem _l są identyczne, z tą różnicą, że używają parametru ustawień regionalnych przekazanych zamiast bieżących ustawień regionalnych. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

TCHAR.H Rutynowych	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tstoi	atoi	atoi	_wtoi
_ttoi	atoi	atoi	_wtoi

Wymagania

Procedur	Wymagany nagłówek
atoi	<stdlib.h>
_atoi_l, , _wtoi_wtoi_l	<stdlib.h> lub <wchar.h>

Przykład

W tym programie pokazano, jak liczby przechowywane jako ciągi można przekonwertować na wartości liczbowe przy użyciu atoi funkcji.

// 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 occurring.
    str = "3336402735171707160320";
    value = atoi( str );
    printf( "Function: atoi( \"%s\" ) = %d\n", str, value );
    if (errno == ERANGE)
    {
       printf("Overflow condition occurred.\n");
    }
}

Function: atoi( "  -2309 " ) = -2309
Function: atoi( "31412764" ) = 31412764
Function: atoi( "3336402735171707160320" ) = 2147483647
Overflow condition occurred.

Zobacz też

Konwersja danych
Obsługa obliczeń matematycznych i zmiennoprzecinkowych
ustawienia regionalne
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, , _atodbl_l, _atoldbl, _atoldbl_l, , _atoflt_atoflt_l