_atoi64, , _atoi64_l, , _wtoi64_wtoi64_l

Konwertuje ciąg na 64-bitową liczbę całkowitą.

Składnia

__int64 _atoi64(
   const char *str
);
__int64 _wtoi64(
   const wchar_t *str
);
__int64 _atoi64_l(
   const char *str,
   _locale_t locale
);
__int64 _wtoi64_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 __int64 wartość wygenerowaną przez interpretowanie znaków wejściowych jako liczby. Wartość zwracana wynosi 0, _atoi64 jeśli nie można przekonwertować danych wejściowych na wartość tego typu.

Jeśli funkcje przepełniają się dużymi dodatnimi wartościami całkowitymi, zwracają wartość I64_MAX. Funkcje zwracają I64_MIN , jeśli przepełniają się dużymi ujemnymi wartościami całkowitymi.

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 64-bitową wartość całkowitą.

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 _atoi64 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ą.

_wtoi64 jest identyczny z _atoi64 tą różnicą, że przyjmuje ciąg znaków szeroki jako parametr.

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

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS zdefiniowany	_UNICODE zdefiniowany
_tstoi64	_atoi64	_atoi64	_wtoi64
_ttoi64	_atoi64	_atoi64	_wtoi64

Wymagania

Procedur	Wymagany nagłówek
_atoi64, _atoi64_l	<stdlib.h>
_wtoi64, _wtoi64_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 _atoi64 funkcji.

// crt_atoi64.c
// This program shows how numbers stored as
// strings can be converted to numeric values
// using the _atoi64 functions.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>

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

    // An example of the _atoi64 function
    // with leading and trailing white spaces.
    str = "  -2309 ";
    value = _atoi64( str );
    printf( "Function: _atoi64( \"%s\" ) = %d\n", str, value );

    // Another example of the _atoi64 function
    // with an arbitrary decimal point.
    str = "314127.64";
    value = _atoi64( str );
    printf( "Function: _atoi64( \"%s\" ) = %d\n", str, value );

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

Function: _atoi64( "  -2309 " ) = -2309
Function: _atoi64( "314127.64" ) = 314127
Function: _atoi64( "3336402735171707160320" ) = -1
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