_atoi64, _atoi64_l, _wtoi64, _wtoi64_l

Bir dizeyi 64 bit tamsayıya dönüştürür.

Sözdizimi

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

Parametreler

str
Dönüştürülecek dize.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Her işlev, giriş karakterlerini sayı olarak yorumlayarak üretilen değeri döndürür __int64 . Giriş, bu türdeki bir değere dönüştürülemiyorsa, dönüş değeri 0'dır _atoi64 .

İşlevler büyük pozitif integral değerleriyle taşıyorsa, döndürür I64_MAX. İşlevler, büyük negatif integral değerleriyle taşıyorsa geri döner I64_MIN .

Tüm aralık dışı durumlarda olarak errno ayarlanır ERANGE. geçirilen parametre iseNULL, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler olarak EINVAL ayarlanır errno ve 0 döndürür.

Açıklamalar

Bu işlevler bir karakter dizesini 64 bit tamsayı değerine dönüştürür.

Giriş dizesi, belirtilen türün sayısal değeri olarak yorumlanabilir bir karakter dizisidir. İşlev, giriş dizesini bir sayının parçası olarak tanıyamayan ilk karakterde okumayı durdurur. Bu karakter, dizeyi sonlandıran null karakter ('\0' veya L'\0') olabilir.

bağımsız str_atoi64 değişkeni aşağıdaki forma sahiptir:

[whitespace] [sign] [digits]

Bir whitespace , yoksayılan boşluk veya sekme karakterlerinden oluşur; sign artı (+) veya eksi (-) olur ve digits bir veya daha fazla basamaktır.

_wtoi64_atoi64 parametresi olarak geniş bir karakter dizesi alması dışında aynıdır.

Bu işlevlerin sonekli _l sürümleri aynıdır, ancak geçerli yerel ayar yerine geçirilen yerel ayar parametresini kullanırlar. Daha fazla bilgi için bkz . Yerel Ayar.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

Tchar.h yordamı	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tstoi64	_atoi64	_atoi64	_wtoi64
_ttoi64	_atoi64	_atoi64	_wtoi64

Gereksinimler

Rutin	Gerekli başlık
_atoi64, _atoi64_l	<stdlib.h>
_wtoi64, _wtoi64_l	<stdlib.h> veya <wchar.h>

Örnek

Bu program, dize olarak depolanan sayıların _atoi64 işlevleri kullanılarak sayısal değerlere nasıl dönüştürülebileceğini gösterir.

// 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.

Ayrıca bkz.

Veri dönüştürme
Matematik ve kayan nokta desteği
Yerel ayar
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l