_ultoa_s, _ultow_s

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Convertir a un entero largo sin signo en una cadena. Estas son versiones de _ultoa, _ultow con mejoras de seguridad, como se describe en características de seguridad de CRT.

errno_t _ultoa_s(  
    unsigned long value,  
    char *str,  
    size_t sizeOfstr,  
    int radix   
);  
errno_t _ultow_s(  
    unsigned long value,  
    wchar_t *str,  
    size_t sizeOfstr,  
    int radix   
);  
template <size_t size>  
errno_t _ultoa_s(  
    unsigned long value,  
    char (&str)[size],  
    int radix   
); // C++ only  
template <size_t size>  
errno_t _ultow_s(  
    unsigned long value,  
    wchar_t (&str)[size],  
    int radix   
); // C++ only  

Parámetros

value
Número que se va a convertir.

str
Cadena de resultado.

sizeOfstr
El tamaño de la str en bytes para _ultoa_s o más palabras para _ultow_s.

radix
Base de value.

Cero si la función se realizó correctamente o un código de error.

El _ultoa_s función convierte los dígitos de value en una cadena de caracteres terminada en null y almacena el resultado (hasta 33 bytes) en str. El radix especifica el argumento de la base de value, que debe estar en el intervalo 2 y 36. _ultow_ses una versión con caracteres anchos de _ultoa_s; el segundo argumento de _ultow_s es cadenas de caracteres anchos.

Si str es una NULL puntero, o si sizeOfstr es menor o igual a cero, se invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, estas funciones devuelven -1 y establezca errno a EINVAL o si la value o str fuera del intervalo de un entero largo, estas funciones devolverá -1 y establezca el errno a ERANGE.

En C++, el uso de estas funciones se simplifica con las sobrecargas de plantilla; las sobrecargas pueden realizar una inferencia automáticamente de la longitud de búfer (lo que elimina el requisito de especificar un argumento de tamaño) y pueden reemplazar automáticamente funciones anteriores no seguras con sus homólogos seguros más recientes. Para obtener más información, consulta Secure Template Overloads.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_ultot_s_ultoa_s_ultoa_s_ultow_s
RutinaEncabezado necesario
_ultoa_s<stdlib.h>
_ultow_s<stdlib.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

System::Convert::ToString

Conversión de datos
_ultoa, _ultow
_ltoa, _ltow
_ltoa_s, _ltow_s
_ltoa_s, _ltow_s

Mostrar: