¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_ultoa_s, _ultow_s

Convierte un entero unsigned long en una cadena. Estas versiones de _ultoa, _ultow tienen 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

value

Número que se va a convertir.

str

Cadena de resultado.

sizeOfstr

El tamaño de str en bytes para _ultoa_s o palabras para _ultow_s.

radix

Base de value.

Cero si la función es correcta o un código de error.

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

Si str es un puntero de NULL , o si sizeOfstr es menor o igual que cero, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones devuelven -1 y errno establecido en EINVAL o si value o str fuera del intervalo de un entero largo, estas funciones devuelve -1 y establece 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 la necesidad 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, vea Sobrecargas de plantilla seguras.

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

Rutina

Encabezado necesario

_ultoa_s

<stdlib.h>

_ultow_s

<stdlib.h>

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft