Condividi tramite


vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l

Scrivere l'output formattato utilizzando un puntatore a un elenco di argomenti. Sono disponibili versioni più sicure di queste funzioni; 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],
   const wchar_t *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vswprintf_l(
   wchar_t (&buffer)[size],
   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, nella versione UNICODE per questa funzione.

  • format
    Specifica di formato,

  • argptr
    Puntatore all'elenco di argomenti.

  • locale
    Impostazioni locali da utilizzare.

Valore restituito

vsprintf e vswprintf restituiscono il numero di caratteri scritti, escluso il carattere di terminazione null, o un valore negativo se un errore di output viene visualizzato. Se buffer o format è un puntatore null, queste funzioni richiamano un gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno su EINVAL.

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

Note

Ognuna di queste funzioni accetta un puntatore ad un elenco di argomenti, quindi formatta e scrive i dati specificati nella locazione di memoria indicata da buffer.

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

Nota sulla sicurezzaNota sulla sicurezza

Con l'utilizzo di vsprintf qui non è possibile limitare il numero di caratteri scritti, ovvero il codice che utilizza questa funzione è soggetto a sovraccarichi del buffer.Utilizzare invece _vsnprintf, oppure chiamare _vscprintf per determinare la quantità di un buffer necessaria.Inoltre, assicurarsi che format non sia una stringa definita dall'utente.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.

vswprintf è conforme allo standard ISO C, che richiede il secondo parametro, count, di tipo size_t. Per definire un comportamento precedente non standard, 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 dei modelli che richiamano le relative controparti sicure e più recenti. Per ulteriori informazioni, vedere Overload di modelli sicuri.

Mapping di routine su testo generico

Routine 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 obbligatoria

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>*

* Necessario per la compatibilità con UNIX V.

Per ulteriori informazioni sulla compatibilità, 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" );
}
  

Equivalente .NET Framework

System::String::Format

Vedere anche

Riferimenti

I/O di flusso

Funzioni vprintf

Sintassi per la specifica del formato: funzioni printf wprintf

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