vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l

Articolo
03/05/2013

Scrivere l'output formattato utilizzando un puntatore a un elenco di argomenti.Più versioni sicure di queste funzioni sono disponibili, vedere vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l.

int vsprintf(
   char *buffer,
   const char *format,
   va_list argptr 
); 
int _vsprintf_l(
   char *buffer,
   const char *format,
   locale_t locale,
   va_list argptr 
); 
int vswprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr 
);
int _vswprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
int __vswprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
template <size_t size>
int vsprintf(
   char (&buffer)[size],
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsprintf_l(
   char (&buffer)[size],
   const char *format,
   locale_t locale,
   va_list argptr 
); // C++ only
template <size_t size>
int vswprintf(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vswprintf_l(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
); // C++ only

Parametri

buffer
Percorso di archiviazione per l'output.
count
Numero massimo di caratteri da archiviare, in UNICODE versione della funzione.
format
Specifica di formato.
argptr
Puntatore all'elenco degli argomenti.
locale
le impostazioni locali da utilizzare.

Valore restituito

vsprintf e vswprintf restituisce il numero di caratteri scritto, escluso il carattere di terminazione null, o un valore negativo se un errore di output si verifica.se buffer o format è un puntatore null, queste funzioni viene richiamato il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni restituiscono -1 e impostate errno in EINVAL.

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

Note

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti e quindi i formati e scrive i dati specificati a quella indicata da buffer.

le versioni di queste funzioni con _l il suffisso è identico con la differenza che utilizzano il parametro delle impostazioni locali passato alle impostazioni locali del thread corrente.

Nota sulla sicurezza
Tramite vsprintf, che non è necessaria alcuna limitare il numero di caratteri scritto, ovvero il codice utilizzando questa funzione è soggetto ai sovraccarichi del buffer.utilizzo _vsnprintf invece, oppure chiamare _vscprintf per determinare la quantità un buffer è necessario.Inoltre, assicurarsi che format non è una stringa definita dall'utente.Per ulteriori informazioni, vedere Evitare i sovraccarichi del buffer.

Tramite vsprintf, che non è necessaria alcuna limitare il numero di caratteri scritto, ovvero il codice utilizzando questa funzione è soggetto ai sovraccarichi del buffer.utilizzo _vsnprintf invece, oppure chiamare _vscprintf per determinare la quantità un buffer è necessario.Inoltre, assicurarsi che format non è una stringa definita dall'utente.Per ulteriori informazioni, vedere Evitare i sovraccarichi del buffer.

vswprintf è conforme allo standard ISO C, che richiede il secondo parametro, count, di tipo size_t.Per definire il comportamento non standard precedente, definire _CRT_NON_CONFORMING_SWPRINTFS. Il comportamento precedente non può trovarsi in una versione futura, il codice deve essere modificato per utilizzare il nuovo comportamento conforme.

In C++, queste funzioni presentano overload del modello da richiamare le più recenti, controparti sicure di queste funzioni.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_vstprintf	vsprintf	vsprintf	vswprintf
_vstprintf_l	_vsprintf_l	_vsprintf_l	_vswprintf_l

Requisiti

routine	Intestazione di associazione	intestazioni facoltative
vsprintf, _vsprintf_l	<stdio.h> e <stdarg.h>	<varargs.h> *
vswprintf, _vswprintf_l	<stdio.h> o <wchar.h> e <stdarg.h>	<varargs.h> *

* Obbligatorio per la compatibilità dell'utilità UNIX V.

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

// crt_vsprintf.c
// compile with: /W3
// This program uses vsprintf to write to a buffer.
// The size of the buffer is determined by _vscprintf.

#include <stdlib.h>
#include <stdio.h>
#include <stdarg.h>

void test( char * format, ... )
{
    va_list args;
    int     len;
    char    *buffer;

    // retrieve the variable arguments
    va_start( args, format );
    
    len = _vscprintf( format, args ) // _vscprintf doesn't count
                                + 1; // terminating '\0'
    
    buffer = (char*)malloc( len * sizeof(char) );

    vsprintf( buffer, format, args ); // C4996
    // Note: vsprintf is deprecated; consider using vsprintf_s instead
    puts( buffer );

    free( buffer );
}

int main( void )
{
   test( "%d %c %d", 123, '<', 456 );
   test( "%s", "This is a string" );
}