_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Artículo
02/19/2013

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 la Formato-CONTROL.
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

_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 de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional del subproceso actual.

Si format es un puntero NULL, 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, las funciones devuelven -1 y errno establecido en EINVAL.

Comentarios

Cada argument (si existe) se convierte según la especificación correspondiente de formato en format.El formato consta de los caracteres ordinarios y tiene el mismo formato y función que el argumento de 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 Para evitar las saturaciones del búfer.