_itoa_s, _i64toa_s, _ui64toa_s, _itow_s, _i64tow_s, _ui64tow_s

Artykuł
06/09/2015

Konwertuje ciąg liczbą całkowitą.Są to wersje _itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow z rozszerzeń zabezpieczeń opisane w Funkcje zabezpieczeń w CRT.

errno_t _itoa_s(
   int value,
   char *buffer,
   size_t sizeInCharacters,
   int radix 
);
errno_t _i64toa_s(
   __int64 value,
   char *buffer,
   size_t sizeInCharacters,
   int radix 
);
errno_t _ui64toa_s(
   unsigned _int64 value,
   char *buffer,
   size_t sizeInCharacters,
   int radix 
);
errno_t _itow_s(
   int value,
   wchar_t *buffer,
   size_t sizeInCharacters,
   int radix 
);
errno_t _i64tow_s(
   __int64 value,
   wchar_t *buffer,
   size_t sizeInCharacters,
   int radix 
);
errno_t _ui64tow_s(
   unsigned __int64 value,
   wchar_t *buffer,
   size_t sizeInCharacters,
   int radix 
);
template <size_t size>
errno_t _itoa_s(
   int value,
   char (&buffer)[size],
   int radix 
); // C++ only
template <size_t size>
errno_t _itow_s(
   int value,
   wchar_t (&buffer)[size],
   int radix 
); // C++ only

Parametry

[w]value
Liczby są konwertowane.
[out]buffer
Wypełnione w wyniku konwersji.
[w]sizeInCharacters
Rozmiar buforu w znaki jednobajtowe lub szerokości znaków.
[w]radix
Base of value; musi być w 2–36 zakresie.

Wartość zwracana

Zero, jeśli kończy się pomyślnie; Kod błędu w przypadku awarii.Jeśli dowolny z następujących warunków ma zastosowanie, funkcja wywołuje funkcję obsługi nieprawidłowy parametr zgodnie z opisem w Sprawdzanie poprawności parametru.

Warunki błędów

wartość	bufor	sizeInCharacters	Podstawa	Zwrot
wszelkie	NULL	wszelkie	wszelkie	EINVAL
wszelkie	wszelkie	< = 0	wszelkie	EINVAL
wszelkie	wszelkie	< = długość ciągu wynik wymagane	wszelkie	EINVAL
wszelkie	wszelkie	wszelkie	radix< 2 or radix > 36	EINVAL

Problemy dotyczące zabezpieczeń

Funkcje te można wygenerować naruszenie zasad dostępu, jeśli buffer nie wskazuje prawidłowy pamięci i nie jest NULL, lub jeśli długość buforu nie jest wystarczająco długi pomieścić ciąg wyniku.

Uwagi

Z wyjątkiem dla parametrów i wartości zwracanej _itoa_s funkcje mają takie samo zachowanie jak odpowiadające im mniej bezpiecznego wersji.

W języku C++ korzystając z tych funkcji jest uproszczona poprzez overloads szablonu; overloads można automatycznie rozpoznać długość buforu (eliminując konieczność należy określić argument rozmiar) i automatycznie można zastąpić starszych, które nie są bezpieczne funkcje z ich odpowiednikami nowsze, bezpieczne.Aby uzyskać więcej informacji, zobacz Przeciążenia bezpiecznych szablonów.

Wersje do debugowania te funkcje najpierw wypełnić bufor z 0xFD.Aby wyłączyć to zachowanie, należy użyć _CrtSetDebugFillThreshold.

Tekst rodzajowy rutynowych mapowania

Procedura TCHAR.h	_UNICODE i _MBCS nie zdefiniowane	_MBCS, definicja	_UNICODE, definicja
_itot_s	_itoa_s	_itoa_s	_itow_s
_i64tot_s	_i64toa_s	_i64toa_s	_i64tow_s
_ui64tot_s	_ui64toa_s	_ui64toa_s	_ui64tow_s

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
_itoa_s	<stdlib.h>
_i64toa_s	<stdlib.h>
_ui64toa_s	<stdlib.h>
_itow_s	<stdlib.h> lub <wchar.h>
_i64tow_s	<stdlib.h> lub <wchar.h>
_ui64tow_s	<stdlib.h> lub <wchar.h>

Informacji dotyczących zgodności, zobacz Zgodność we wprowadzeniu.

Przykład

// crt_itoa_s.c
#include <stdlib.h>
#include <string.h>

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

Dane wyjściowe

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)