vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, , _vsnwprintf_s, _vsnwprintf_s_l

Escriba una salida con formato mediante un puntero a una lista de argumentos. Estas funciones son versiones de , vsnprintf, _vsnprintf, , _vsnprintf_lcon _vsnwprintfmejoras de seguridad, tal y como se describe en Características de_vsnwprintf_lseguridad en el CRT.

Sintaxis

int vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s_l(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   _locale_t locale,
   va_list argptr
);

int _vsnwprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   va_list argptr
);

int _vsnwprintf_s_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

template <size_t size>
int _vsnprintf_s(
   char (&buffer)[size],
   size_t count,
   const char *format,
   va_list argptr
); // C++ only

template <size_t size>
int _vsnwprintf_s(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr
); // C++ only

Parámetros

buffer
Ubicación de almacenamiento para la salida.

sizeOfBuffer
El tamaño de la buffer salida for. Tamaño en bytes para las funciones que toman char, y palabras para las que toman wchar_t.

count
Número máximo de caracteres que se van a escribir, sin incluir el archivo NULL. Para las funciones que toman wchar_t, es el número de caracteres anchos que se van a escribir. O _TRUNCATE.

format
Especificación de formato.

argptr
Puntero a la lista de argumentos.

locale
La configuración regional que se va a utilizar al dar formato a la salida.

Para obtener más información, consulte Especificaciones de formato.

Valor devuelto

El número de caracteres escritos, sin incluir la terminación NULL, o un valor negativo si se produce un error de salida.

Consulte Resumen del comportamiento para obtener más información.

Observaciones

Cada una de estas funciones toma un puntero a una lista de argumentos, luego formatea y escribe hasta count los caracteres de los datos dados en la memoria a la que apunta buffer y agrega un archivo NULL.

En las compilaciones de depuración, los bytes restantes sizeOfBuffer después de la terminación NULL se rellenan con 'xFE' como se describe en _CrtSetDebugFillThreshold.

Las versiones de estas funciones con el _l sufijo son idénticas, excepto que utilizan el parámetro de configuración regional pasado en lugar de la configuración regional del subproceso actual.

vsnprintf_s es idéntico y _vsnprintf_s se incluye para cumplir con el estándar ANSI. _vnsprintf se conserva por compatibilidad con versiones anteriores.

Resumen del comportamiento

Para la tabla siguiente:

• Vamos len a ser el tamaño de los datos con formato. Si la función toma un char búfer, el tamaño está en bytes. Si la función toma un wchar_t búfer, el tamaño especifica el número de palabras de 16 bits.
• Los caracteres hacen referencia a char caracteres para funciones que toman un char búfer y a wchar_t caracteres para las funciones que toman un wchar_t búfer.
• Para obtener más información sobre el controlador de parámetros no válidos, vea Validación de parámetros.

Para información sobre estos y otros códigos de error, consulte _doserrno, errno_sys_errlist y _sys_nerr.

En C++, el uso de estas funciones se simplifica mediante sobrecargas de plantillas; Las sobrecargas pueden inferir la longitud del búfer automáticamente (lo que elimina la necesidad de especificar un argumento de tamaño) y pueden reemplazar automáticamente las funciones más antiguas y no seguras por sus homólogas más nuevas y seguras. Para obtener más información, consulte Sobrecargas de plantilla seguras.

Asignaciones de rutinas de texto genérico

Requisitos

* Necesario para la compatibilidad con UNIX V.

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

// crt_vsnprintf_s.cpp
#include <stdio.h>
#include <wtypes.h>

void FormatOutput(LPCSTR formatstring, ...)
{
   int nSize = 0;
   char buff[10];
   memset(buff, 0, sizeof(buff));
   va_list args;
   va_start(args, formatstring);
   nSize = vsnprintf_s( buff, _countof(buff), _TRUNCATE, formatstring, args);
   printf("nSize: %d, buff: %s\n", nSize, buff);
   va_end(args);
}

int main() {
   FormatOutput("%s %s", "Hi", "there");
   FormatOutput("%s %s", "Hi", "there!");
   FormatOutput("%s %s", "Hi", "there!!");
}

nSize: 8, buff: Hi there
nSize: 9, buff: Hi there!
nSize: -1, buff: Hi there!

Consulte también

E/S de secuencia
Funciones vprintf
fprintf, _fprintf_l, , fwprintf, _fwprintf_l
printf, _printf_l, , wprintf, _wprintf_l
sprintf, , _sprintf_l, swprintf, _swprintf_l, __swprintf_l
va_arg, va_copy, , va_end, va_start