_itoa_s, _ltoa_s, _ultoa_s, _i64toa_s, _ui64toa_s, _itow_s, _ltow_s, _ultow_s, _i64tow_s, _ui64tow_s

Tamsayıyı dizeye dönüştürür. Bu işlevler, CRT'deki _itow_itoaGüvenlik özellikleri bölümünde açıklandığı gibi güvenlik geliştirmeleri içeren , işlevlerinin sürümleridir.

Sözdizimi

errno_t _itoa_s( int value, char * buffer, size_t size, int radix );
errno_t _ltoa_s( long value, char * buffer, size_t size, int radix );
errno_t _ultoa_s( unsigned long value, char * buffer, size_t size, int radix );
errno_t _i64toa_s( long long value, char *buffer,
   size_t size, int radix );
errno_t _ui64toa_s( unsigned long long value, char *buffer,
   size_t size, int radix );

errno_t _itow_s( int value, wchar_t *buffer,
   size_t size, int radix );
errno_t _ltow_s( long value, wchar_t *buffer,
   size_t size, int radix );
errno_t _ultow_s( unsigned long value, wchar_t *buffer,
   size_t size, int radix );
errno_t _i64tow_s( long long value, wchar_t *buffer,
   size_t size, int radix );
errno_t _ui64tow_s( unsigned long long value, wchar_t *buffer,
   size_t size, int radix
);

// These template functions are C++ only:
template <size_t size>
errno_t _itoa_s( int value, char (&buffer)[size], int radix );

template <size_t size>
errno_t _ltoa_s( long value, char (&buffer)[size], int radix );

template <size_t size>
errno_t _ultoa_s( unsigned long value, char (&buffer)[size], int radix );

template <size_t size>
errno_t _itow_s( int value, wchar_t (&buffer)[size], int radix );

template <size_t size>
errno_t _ltow_s( long value, wchar_t (&buffer)[size], int radix );

template <size_t size>
errno_t _ultow_s( unsigned long value, wchar_t (&buffer)[size], int radix );

Parametreler

value
Dönüştürülecek sayı.

buffer
Dönüştürmenin sonucunu tutan çıkış arabelleği.

size
buffer Boyutu karakter veya geniş karakter cinsindendir.

radix
dönüştürmek için valuekullanılacak sayı tabanı veya 2-36 aralığında olması gerekir.

Dönüş değeri

Başarılı olursa sıfır; hatayla ilgili bir hata kodu. Aşağıdaki koşullardan herhangi biri geçerliyse, işlev Parametre doğrulama bölümünde açıklandığı gibi geçersiz bir parametre işleyicisi çağırır.

Hata koşulları

value	Arabellek	size	Radix	İade
herhangi bir	NULL	herhangi bir	herhangi bir	EINVAL
herhangi bir	herhangi bir	<=0	herhangi bir	EINVAL
herhangi bir	herhangi bir	<= gerekli sonuç dizesinin uzunluğu	herhangi bir	EINVAL
herhangi bir	herhangi bir	herhangi bir	radix< 2 veya radix> 36	EINVAL

Güvenlik sorunları

Bu işlevler geçerli belleğe işaret etmiyorsa buffer ve NULLdeğilse veya arabellek uzunluğu sonuç dizesini tutacak kadar uzun değilse erişim ihlali oluşturabilir.

Açıklamalar

Parametreler ve dönüş değeri dışında ve _itow_s işlev aileleri, _itoa_s karşılık gelen daha az güvenli _itoa ve _itow sürümlerle aynı davranışa sahiptir.

C++'ta bu işlevlerin kullanılması şablon aşırı yüklemeleriyle basitleştirilir; aşırı yüklemeler arabellek uzunluğunu otomatik olarak çıkarabilir (boyut bağımsız değişkeni belirtme gereksinimini ortadan kaldırır) ve eski, güvenli olmayan işlevleri yeni ve güvenli karşılıklarıyla otomatik olarak değiştirebilir. Daha fazla bilgi için bkz . Güvenli şablon aşırı yüklemeleri.

Bu işlevlerin hata ayıklama kitaplığı sürümleri önce arabelleği 0xFE ile doldurur. Bu davranışı devre dışı bırakmak için kullanın _CrtSetDebugFillThreshold.

CRT, null sonlandırıcı ve işaret karakteri de dahil olmak üzere her tamsayı türünün mümkün olan en uzun değerini çeşitli ortak tabanlar için dönüştürmek için gereken arabellek boyutunu tanımlamak için uygun makrolar içerir. Bilgi için bkz . En fazla dönüştürme sayısı makroları.

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
_itot_s	_itoa_s	_itoa_s	_itow_s
_ltot_s	_ltoa_s	_ltoa_s	_ltow_s
_ultot_s	_ultoa_s	_ultoa_s	_ultow_s
_i64tot_s	_i64toa_s	_i64toa_s	_i64tow_s
_ui64tot_s	_ui64toa_s	_ui64toa_s	_ui64tow_s

Gereksinimler

Yordam	Gerekli başlık
_itoa_s, _ltoa_s, _ultoa_s, _i64toa_s, _ui64toa_s	<stdlib.h>
_itow_s, _ltow_s, _ultow_s, _i64tow_s, _ui64tow_s	<stdlib.h> veya <wchar.h>

Bu işlevler Microsoft'a özeldir. Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

Bu örnek, tamsayı dönüştürme işlevlerinden birkaçının kullanımını gösterir. Makro _countof yalnızca dizi bildirimi derleyici tarafından görünür olduğunda arabellek boyutunu belirlemek için çalışır, işaretçiler için bozulan parametreler için değil.

// crt_itoa_s.c
// Compile by using: cl /W4 crt_itoa_s.c
#include <stdlib.h>     // for _itoa_s functions, _countof, count macro
#include <stdio.h>      // for printf
#include <string.h>     // for strnlen

int main( void )
{
    char buffer[_MAX_U64TOSTR_BASE2_COUNT];
    int r;
    for ( r = 10; r >= 2; --r )
    {
        _itoa_s( -1, buffer, _countof(buffer), r );
        printf( "base %d: %s (%d chars)\n",
            r, buffer, strnlen(buffer, _countof(buffer)) );
    }
    printf( "\n" );
    for ( r = 10; r >= 2; --r )
    {
        _i64toa_s( -1LL, buffer, _countof(buffer), r );
        printf( "base %d: %s (%d chars)\n",
            r, buffer, strnlen(buffer, _countof(buffer)) );
    }
    printf( "\n" );
    for ( r = 10; r >= 2; --r )
    {
        _ui64toa_s( 0xffffffffffffffffULL, buffer, _countof(buffer), r );
        printf( "base %d: %s (%d chars)\n",
            r, buffer, strnlen(buffer, _countof(buffer)) );
    }
}

base 10: -1 (2 chars)
base 9: 12068657453 (11 chars)
base 8: 37777777777 (11 chars)
base 7: 211301422353 (12 chars)
base 6: 1550104015503 (13 chars)
base 5: 32244002423140 (14 chars)
base 4: 3333333333333333 (16 chars)
base 3: 102002022201221111210 (21 chars)
base 2: 11111111111111111111111111111111 (32 chars)

base 10: -1 (2 chars)
base 9: 145808576354216723756 (21 chars)
base 8: 1777777777777777777777 (22 chars)
base 7: 45012021522523134134601 (23 chars)
base 6: 3520522010102100444244423 (25 chars)
base 5: 2214220303114400424121122430 (28 chars)
base 4: 33333333333333333333333333333333 (32 chars)
base 3: 11112220022122120101211020120210210211220 (41 chars)
base 2: 1111111111111111111111111111111111111111111111111111111111111111 (64 chars)

base 10: 18446744073709551615 (20 chars)
base 9: 145808576354216723756 (21 chars)
base 8: 1777777777777777777777 (22 chars)
base 7: 45012021522523134134601 (23 chars)
base 6: 3520522010102100444244423 (25 chars)
base 5: 2214220303114400424121122430 (28 chars)
base 4: 33333333333333333333333333333333 (32 chars)
base 3: 11112220022122120101211020120210210211220 (41 chars)
base 2: 1111111111111111111111111111111111111111111111111111111111111111 (64 chars)

Ayrıca bkz.

Veri dönüştürme
_itoa, _itow işlevler