vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s_vsnwprintf_s_l

Scrivere l'output formattato mediante un puntatore a un elenco di argomenti. Queste funzioni sono versioni di , , , , , _vsnwprintf_l con miglioramenti della sicurezza, come descritto in Funzionalità di sicurezza in CRT. _vsnwprintf_vsnprintf_l_vsnprintfvsnprintf

Sintassi

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

Parametri

buffer
Percorso di archiviazione per l'output.

sizeOfBuffer
Dimensioni dell'oggetto per l'output buffer . Dimensioni in byte per le funzioni che accettano charle parole e per quelle che accettano wchar_t.

count
Numero massimo di caratteri da scrivere senza includere l'oggetto di terminazione NULL. Per le funzioni che accettano wchar_t, è il numero di caratteri wide da scrivere. Oppure _TRUNCATE.

format
Specifica di formato.

argptr
Puntatore a un elenco di argomenti.

locale
Impostazioni locali da utilizzare per la formattazione dell'output.

Per altre informazioni, vedere Specifiche di formato.

Valore restituito

Numero di caratteri scritti, senza includere l'terminazione NULLo un valore negativo se si verifica un errore di output.

Per informazioni dettagliate, vedere Riepilogo del comportamento .

Osservazioni:

vsnprintf_s è identico a _vsnprintf_s e è incluso per la conformità allo standard ANSI. _vnsprintf viene mantenuta per compatibilità con le versioni precedenti.

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi formatta scrive fino a count caratteri nella memoria a cui punta buffer e aggiunge un carattere Null di terminazione.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione per il fatto che utilizzano il parametro delle impostazioni locali passato al posto di quelle del thread corrente.

Riepilogo del comportamento

Per la tabella seguente:

• Si supponga di len essere la dimensione dei dati formattati. Se la funzione accetta un char buffer, le dimensioni sono in byte. Se la funzione accetta un wchar_t buffer, la dimensione specifica il numero di parole a 16 bit.
• I caratteri fanno riferimento ai char caratteri per le funzioni che accettano un char buffer e ai wchar_t caratteri per le funzioni che accettano un wchar_t buffer.
• Per altre informazioni sul gestore di parametri non validi, vedere Convalida dei parametri.

Per informazioni su questi e altri codici di errore, vedere _doserrno, errno, _sys_errliste _sys_nerr.

In C++ l'utilizzo di queste funzioni è semplificato dagli overload dei modelli. Gli overload possono dedurre la lunghezza del buffer automaticamente (eliminando la necessità di specificare un argomento di dimensione) e possono sostituire automaticamente le funzioni precedenti e non sicure con le controparti più recenti e sicure. Per altre informazioni, vedere Proteggere gli overload dei modelli.

Mapping di routine di testo generico

Requisiti

* Obbligatorio per la compatibilità di UNIX V.

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// 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!

Vedi anche

I/O di flusso
Funzioni 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_endva_start