_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l
Devuelve el número de caracteres de la cadena con formato mediante un puntero a una lista de argumentos.
int _vscprintf(
const char *format,
va_list argptr
);
int _vscprintf_l(
const char *format,
locale_t locale,
va_list argptr
);
int _vscwprintf(
const wchar_t *format,
va_list argptr
);
int _vscwprintf_l(
const wchar_t *format,
locale_t locale,
va_list argptr
);
Parámetros
format
Cadena de control de formato.argptr
Puntero a la lista de argumentos.locale
Configuración regional que se va a usar.
Para obtener más información, vea Especificaciones de formato.
Valor devuelto
_vscprintf devuelve el número de caracteres que se generará si la cadena indicada por a la lista de argumentos se imprimirá o enviada a un archivo o un búfer mediante los códigos de formato especificados. El valor devuelto no incluye el carácter null de terminación. _vscwprintf realiza la misma función por caracteres anchos.
Las versiones de estas funciones con el sufijo _l son idénticas salvo que usan el parámetro locale pasado en lugar de la configuración regional del subproceso actual.
Si format es un puntero nulo, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, las funciones devuelven -1 y establecen errno en EINVAL.
Comentarios
Cada argument (si existe) se convierte según la especificación correspondiente de formato en format. El formato consta de caracteres ordinarios y tiene el mismo formato y función que el argumento format para printf.
Nota sobre la seguridad |
---|
Asegúrese de que si format es una cadena definida por el usuario, sea null finalizada y tiene el número y el tipo correctos de parámetros.Para obtener más información, vea Evitar saturaciones del búfer. |
Asignaciones de rutina de texto genérico
Rutina TCHAR.H |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_vsctprintf |
_vscprintf |
_vscprintf |
_vscwprintf |
_vsctprintf_l |
_vscprintf_l |
_vscprintf_l |
_vscwprintf_l |
Requisitos
Rutina |
Encabezado necesario |
---|---|
_vscprintf, _vscprintf_l |
<stdio.h> |
_vscwprintf, _vscwprintf_l |
<stdio.h> o <wchar.h> |
Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.
Ejemplo
Vea el ejemplo para vsprintf.
Vea también
Referencia
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
scanf, _scanf_l, wscanf, _wscanf_l