_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_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, con la capacidad de especificar el orden en el que se utilizan los argumentos.

int _vscprintf_p(
   const char *format,
   va_list argptr 
);
int _vscprintf_p _l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_p _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_p 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_p realiza la misma función por caracteres anchos.

Comentarios

Estas funciones solo se diferencian de _vscprintf y _vscwprintf en que tienen la capacidad de especificar el orden en el que se usan los argumentos. Para obtener más información, vea printf_p (Parámetros de posición).

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.

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.