_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Artículo
06/09/2015

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.