_ltoa_s, _ltow_s

 

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

Convierte a un entero largo en una cadena. Estas son versiones de _ltoa, _ltow con mejoras de seguridad, como se describe en características de seguridad de CRT.

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

Parámetros

value
Número que se va a convertir.

str
Búfer de la cadena resultante.

sizeOfstr
Tamaño de la str en bytes para _ltoa_s o más palabras para _ltow_s.

radix
Base de value.

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

El _ltoa_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. Si radix es igual a 10 y value es negativo, el primer carácter de la cadena almacenada es el signo menos (-). _ltow_ses una versión con caracteres anchos de _ltoa_s; el segundo argumento de _ltow_s es cadenas de caracteres anchos.

Si str es una NULL puntero o sizeOfstr es menor o igual a cero, estas funciones invocan un 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 devuelven -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
_ltot_s_ltoa_s_ltoa_s_ltow_s
RutinaEncabezado necesario
_ltoa_s<stdlib.h>
_ltow_s<stdlib.h>

Para obtener más información sobre compatibilidad, vea Compatibility en la introducción.

System::Convert::ToString

Conversión de datos
_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow
_ultoa, _ultow
_ultoa_s, _ultow_s

Mostrar: