atoi, _atoi_l, _wtoi, _wtoi_l

Dizeyi tamsayıya dönüştürün.

Sözdizimi

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

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 int . Giriş bu tür bir değere dönüştürülemiyorsa, ve için atoi_wtoidönüş değeri 0'dır.

İşlevler büyük negatif integral değerleriyle taştığında döndürülür LONG_MIN . atoi ve _wtoi bu koşullarda geri dönün INT_MAXINT_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 tamsayı değerine (atoi ve _wtoi) 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.

str ve atoi_wtoi bağımsız değişkeni aşağıdaki forma sahiptir:

[whitespace] [] [digitssign]

Bir whitespace , yoksayılan boşluk veya sekme karakterlerinden oluşur; sign artı (+) veya eksi (-) olur ve digits bir veya daha fazla basamaktı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 Rutin	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tstoi	atoi	atoi	_wtoi
_ttoi	atoi	atoi	_wtoi

Gereksinimler

Rutin	Gerekli başlık
atoi	<stdlib.h>
_atoi_l, _wtoi, _wtoi_l	<stdlib.h> veya <wchar.h>

Örnek

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

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

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