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

Mengonversi bilangan bulat menjadi string. Fungsi-fungsi ini adalah versi , _itoa_itow fungsi dengan peningkatan keamanan seperti yang dijelaskan dalam Fitur keamanan di CRT.

Sintaks

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

Parameter

value
Angka yang akan dikonversi.

buffer
Buffer output yang menyimpan hasil konversi.

size
buffer Ukuran dalam karakter atau karakter lebar.

radix
Radix atau basis numerik untuk digunakan untuk mengonversi value, yang harus dalam rentang 2-36.

Nilai hasil

Nol jika berhasil; kode kesalahan pada kegagalan. Jika salah satu kondisi berikut berlaku, fungsi memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter.

Kondisi kesalahan

value	Buffer	size	Radix	Tampilkan
any	NULL	any	any	EINVAL
any	any	<=0	any	EINVAL
any	any	<= panjang string hasil yang diperlukan	any	EINVAL
any	any	any	radix< 2 atau radix> 36	EINVAL

Masalah keamanan

Fungsi-fungsi ini dapat menghasilkan pelanggaran akses jika buffer tidak menunjuk ke memori yang valid dan tidak NULL, atau jika panjang buffer tidak cukup lama untuk menahan string hasil.

Keterangan

Kecuali untuk parameter dan nilai pengembalian, _itoa_s keluarga fungsi dan _itow_s memiliki perilaku yang sama dengan versi dan _itow yang kurang aman _itoa yang sesuai.

Di C++, menggunakan fungsi-fungsi ini disederhanakan oleh kelebihan beban templat; kelebihan beban dapat menyimpulkan panjang buffer secara otomatis (menghilangkan kebutuhan untuk menentukan argumen ukuran) dan mereka dapat secara otomatis mengganti fungsi lama yang tidak aman dengan rekan-rekan yang lebih baru dan aman. Untuk informasi selengkapnya, lihat Mengamankan kelebihan beban templat.

Versi pustaka debug dari fungsi-fungsi ini terlebih dahulu mengisi buffer dengan 0xFE. Untuk menonaktifkan perilaku ini, gunakan _CrtSetDebugFillThreshold.

CRT mencakup makro yang nyaman untuk menentukan ukuran buffer yang diperlukan untuk mengonversi nilai terpanjang dari setiap jenis bilangan bulat, termasuk terminator null dan karakter tanda, untuk beberapa basis umum. Untuk informasi, lihat Makro jumlah konversi maksimum.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

Tchar.h Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_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

Persyaratan

Rutin	Header yang diperlukan
_itoa_s, _ltoa_s, _ultoa_s, _i64toa_s, _ui64toa_s	<stdlib.h>
_itow_s, _ltow_s, _ultow_s, _i64tow_s, _ui64tow_s	<stdlib.h> atau <wchar.h>

Fungsi-fungsi ini khusus Microsoft. Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Sampel ini menunjukkan penggunaan beberapa fungsi konversi bilangan bulat. _countof Makro hanya berfungsi untuk menentukan ukuran buffer ketika deklarasi array terlihat oleh pengkompilasi, dan bukan untuk parameter yang telah membusuk ke penunjuk.

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

Baca juga

Konversi data
_itoa, _itow fungsi