_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l
Escriba el formato en la consola mediante un puntero a una lista de argumentos.Éstas son versiones de _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l con mejoras de seguridad como se describe en Características de seguridad en CRT.
Importante |
---|
Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /ZW. |
int _vcprintf(
const char* format,
va_list argptr
);
int _vcprintf(
const char* format,
locale_t locale,
va_list argptr
);
int _vcwprintf_s(
const wchar_t* format,
va_list argptr
);
int _vcwprintf_s_l(
const wchar_t* format,
locale_t locale,
va_list argptr
);
Parámetros
format
Especificación de formato.argptr
Puntero a la lista de argumentos.locale
La configuración regional a utilizar.
Para obtener más información, vea Especificaciones de formato.
Valor devuelto
El número de caracteres con tipo, o un valor negativo si un error de salida aparece.
Como la versión de que Secure de estas funciones, si format es un puntero NULL, el controlador no válido de parámetro se invoca, como se describe en Validación de parámetros.Además, a diferencia de la versión de que Secure de estas funciones, si format no especifica un formato válido, se genera una excepción no válida del parámetro.Si la ejecución puede continuar, estas funciones vuelven
Comentarios
Cada una de estas funciones contiene un puntero a una lista de argumentos, los formatos y escribe los datos especificados en la consola._vcwprintf_s constituye la versión con caracteres anchos de _vcprintf_s.Toma una cadena de caracteres como argumento.
Las versiones de estas funciones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional actual.
Nota sobre la seguridad |
---|
Asegúrese de que format no es una cadena definida por el usuario.Para obtener más información, vea Para evitar las saturaciones del búfer. |
Asignaciones de la rutina de Genérico- texto
Rutina de TCHAR.H |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_vtcprintf_s |
_vcprintf_s |
_vcprintf_s |
_vcwprintf_s |
_vtcprintf_s_l |
_vcprintf_s_l |
_vcprintf_s_l |
_vcwprintf_s_l |
Requisitos
Rutina |
Encabezado necesario |
Encabezados opcionales |
---|---|---|
_vcprintf_s, _vcprintf_s_l |
<conio.h> y <stdarg.h> |
<varargs.h>* |
_vcwprintf_s, _vcwprintf_s_l |
<conio.h> o <wchar.h>, y <stdarg.h> |
<varargs.h>* |
* Necesario para la compatibilidad de UNIX V.
Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.
Ejemplo
// crt_vcprintf_s.cpp
#include <conio.h>
#include <stdarg.h>
// An error formatting function used to print to the console.
int eprintf_s(const char* format, ...)
{
va_list args;
va_start(args, format);
return _vcprintf_s(format, args);
}
int main()
{
eprintf_s(" (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
"<some error text>");
eprintf_s(" (Related to symbol '%s' defined on line %d).\n",
"<symbol>", 5 );
}
Equivalente en .NET Framework
Vea también
Referencia
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l