_ultoa_s, _ultow_s

Artículo
02/19/2013

Convierte un entero unsigned long en una cadena.Éstas son versiones de _ultoa, _ultow con mejoras de seguridad como se describe en Características de seguridad en 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
resultado de la cadena.
sizeOfstr
El tamaño de str en bytes para _ultoa_s o palabras para _ultow_s.
radix
base de value.

Valor devuelto

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

Comentarios

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 EINVALo si value o str fuera del intervalo de un entero largo, estas funciones devuelve -1 y establece errno a ERANGE.

En C++, mediante estas funciones es simplificado con sobrecargas de plantilla; las sobrecargas pueden deducir la longitud de búfer automáticamente (que elimina la necesidad de especificar un argumento de tamaño) y automáticamente pueden reemplazar anterior, funciones de no con sus más recientes, seguros homólogos.Para obtener más información, vea Sobrecargas de plantilla de seguridad.

Asignaciones de la rutina de texto genérico