_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow

Artículo
02/19/2013

Convierte un entero en una cadena.Versiones más seguras de estas funciones están disponibles; vea _itoa_s, _i64toa_s, _ui64toa_s, _itow_s, _i64tow_s, _ui64tow_s.

char *_itoa(
   int value,
   char *str,
   int radix 
);
char *_i64toa(
   __int64 value,
   char *str,
   int radix 
);
char * _ui64toa(
   unsigned _int64 value,
   char *str,
   int radix 
);
wchar_t * _itow(
   int value,
   wchar_t *str,
   int radix 
);
wchar_t * _i64tow(
   __int64 value,
   wchar_t *str,
   int radix 
);
wchar_t * _ui64tow(
   unsigned __int64 value,
   wchar_t *str,
   int radix 
);
template <size_t size>
char *_itoa(
   int value,
   char (&str)[size],
   int radix 
); // C++ only
template <size_t size>
char *_i64toa(
   __int64 value,
   char (&str)[size],
   int radix 
); // C++ only
template <size_t size>
char * _ui64toa(
   unsigned _int64 value,
   char (&str)[size],
   int radix 
); // C++ only
template <size_t size>
wchar_t * _itow(
   int value,
   wchar_t (&str)[size],
   int radix 
); // C++ only
template <size_t size>
wchar_t * _i64tow(
   __int64 value,
   wchar_t (&str)[size],
   int radix 
); // C++ only
template <size_t size>
wchar_t * _ui64tow(
   unsigned __int64 value,
   wchar_t (&str)[size],
   int radix 
); // C++ only

Parámetros

value
Número que se va a convertir.
str
resultado de la cadena.
radix
base de value; qué debe estar en el intervalo 2-36.

Valor devuelto

Cada una de estas funciones devuelve un puntero a str.No hay retorno de error.

Comentarios

_itoa, _i64toa, y las funciones de _ui64toa convierten los dígitos de argumento determinado de value en una cadena de caracteres terminada en null y almacena el resultado (hasta 33 caracteres para _itoa y 65 para _i64toa y _ui64toa) en str.Si radix es igual a 10 y value es negativo, el primer carácter de la cadena almacenada es el signo menos (– )._itow, _i64tow, y _ui64tow son versiones de caracteres anchos de _itoa, de _i64toa, y de _ui64toa, respectivamente.

Nota sobre la seguridad
Para evitar las saturaciones del búfer, asegúrese de que el búfer de str es bastante grande para contener los dígitos convertidos más el nulo-carácter final y un carácter de signo.

En C++, estas funciones tienen sobrecargas de plantilla que se invoque según el nuevo, garantiza que sus homólogos de estas funciones.Para obtener más información, vea Sobrecargas de plantilla de seguridad.

Asignaciones de la rutina de texto genérico

rutina de Tchar.h	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_itot	_itoa	_itoa	_itow
_i64tot	_i64toa	_i64toa	_i64tow
_ui64tot	_ui64toa	_ui64toa	_ui64tow

Requisitos

rutina	Encabezado necesario
_itoa	<stdlib.h>
_i64toa	<stdlib.h>
_ui64toa	<stdlib.h>
_itow	<stdlib.h>
_i64tow	<stdlib.h>
_ui64tow	<stdlib.h>

Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

// crt_itoa.c
// compile with: /W3
// This program makes use of the _itoa functions
// in various examples.

#include <string.h>
#include <stdlib.h>

int main( void )
{
   char buffer[65];
   int r;
   for( r=10; r>=2; --r )
   {
     _itoa( -1, buffer, r ); // C4996
     // Note: _itoa is deprecated; consider using _itoa_s instead
     printf( "base %d: %s (%d chars)\n", r, buffer, strnlen(buffer, _countof(buffer)) );
   }
   printf( "\n" );
   for( r=10; r>=2; --r )
   {
     _i64toa( -1L, buffer, r ); // C4996
     // Note: _i64toa is deprecated; consider using _i64toa_s
     printf( "base %d: %s (%d chars)\n", r, buffer, strnlen(buffer, _countof(buffer)) );
   }
   printf( "\n" );
   for( r=10; r>=2; --r )
   {
     _ui64toa( 0xffffffffffffffffL, buffer, r ); // C4996
     // Note: _ui64toa is deprecated; consider using _ui64toa
     printf( "base %d: %s (%d chars)\n", r, buffer, strnlen(buffer, _countof(buffer)) );
   }
}