sprintf, _sprintf_l, swprintf, _swprintf, _swprintf_l__swprintf_l

Scrivere dati formattati in una stringa. Sono disponibili versioni più sicure di alcune di queste funzioni; vedere sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l. Le versioni sicure di swprintf e _swprintf_l accettano le dimensioni del buffer come parametro.

Sintassi

int sprintf(
   char *buffer,
   const char *format [,
   argument] ...
);

int _sprintf_l(
   char *buffer,
   const char *format,
   _locale_t locale [,
   argument] ...
);

int swprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format [,
   argument]...
);

int _swprintf(
   wchar_t *buffer,
   const wchar_t *format [,
   argument]...
);

int _swprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   _locale_t locale [,
   argument] ...
);

int __swprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   _locale_t locale [,
   argument] ...
);

template <size_t size>
int sprintf(
   char (&buffer)[size],
   const char *format [,
   argument] ...
); // C++ only

template <size_t size>
int _sprintf_l(
   char (&buffer)[size],
   const char *format,
   _locale_t locale [,
   argument] ...
); // C++ only

Parametri

buffer
Percorso di archiviazione per l'output

count
Numero massimo di caratteri da archiviare nella versione Unicode di questa funzione.

format
Stringa di controllo del formato

argument
Argomenti facoltativi

locale
Impostazioni locali da usare.

Per altre informazioni, vedere Sintassi delle specifiche di formato.

Valore restituito

Numero di caratteri scritti o -1 se si è verificato un errore. Se buffer o format è un puntatore Null, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono -1 e impostano errno su EINVAL.

sprintf restituisce il numero di byte archiviato in buffer, senza contare il carattere Null terminale. swprintf restituisce il numero di caratteri "wide" archiviati in buffer, senza contare il carattere "wide" Null finale.

Osservazioni:

La funzione sprintf formatta e archivia una serie di caratteri e di valori in buffer. Ogni funzione argument (se presente) viene convertita e restituita in base al formato specificato in format. Il formato è costituito da caratteri ordinari e ha lo stesso formato e la stessa funzione dell'argomento format per printf. Un carattere Null viene aggiunto dopo l'ultimo carattere scritto. Se la copia avviene tra stringhe che si sovrappongono, il comportamento non è definito.

Importante

Se si usa sprintf, non è possibile limitare il numero di caratteri scritti, ovvero codice che usa sprintf è soggetto a sovraccarichi del buffer. Prendere in considerazione l'uso della funzione snprintfcorrelata , che specifica un numero massimo di caratteri da scrivere in bufferoppure usare _scprintf per determinare la dimensione necessaria di un buffer. Assicurarsi anche che format non sia una stringa definita dall'utente.

A partire da Windows 10 versione 2004 (build 19041), la printf famiglia di funzioni stampa numeri a virgola mobile esattamente rappresentabili in base alle regole IEEE 754 per l'arrotondamento. Nelle versioni precedenti di Windows, i numeri a virgola mobile che terminano in '5' verrebbero sempre arrotondati. IEEE 754 indica che devono essere arrotondati alla cifra pari più vicina (nota anche come "Arrotondamento del banchiere"). Ad esempio, sia printf("%1.0f", 1.5) che printf("%1.0f", 2.5) devono essere arrotondati a 2. In precedenza, 1,5 arrotonderebbe a 2 e 2,5 arrotonderebbe a 3. Questa modifica influisce solo sui numeri rappresentabili esattamente. Ad esempio, 2.35 (che, se rappresentato in memoria, è più vicino a 2,350000000000000008) continua a arrotondare fino a 2,4. L'arrotondamento eseguito da queste funzioni ora rispetta anche la modalità di arrotondamento a virgola mobile impostata da fesetround. In precedenza, l'arrotondamento ha sempre scelto FE_TONEAREST il comportamento. Questa modifica interessa solo i programmi compilati con Visual Studio 2019 versione 16.2 e successive. Per usare il comportamento di arrotondamento a virgola mobile legacy, collegarsi a "legacy_stdio_float_rounding.obj".

swprintf è una versione a caratteri "wide" di sprintf. Gli argomenti puntatori per swprintf sono stringhe a caratteri "wide". Il rilevamento degli errori di codifica in swprintf può differire da sprintf. swprintf e fwprintf si comportano in modo identico, tranne swprintf che scrive l'output in una stringa anziché in una destinazione di tipo FILEe swprintf richiede il count parametro per specificare il numero massimo di caratteri da scrivere. Le versioni di queste funzioni con il _l suffisso sono identiche, ma usano il parametro delle impostazioni locali passato anziché le impostazioni locali del thread corrente.

Prima della standardizzazione della firma per swprintf , una versione fornita in una libreria di runtime di Microsoft C precedente che non accettava il parametro del conteggio dei caratteri. La versione precedente è ancora disponibile nella libreria di runtime di Microsoft C, ma è deprecata ed è stata rinominata _swprintf(). Per il codice scritto sulla firma precedente, definire _CRT_NON_CONFORMING_SWPRINTFS, che esegue il mapping delle chiamate a a swprintf _swprintf. In una versione futura, il comportamento precedente potrebbe venire rimosso, quindi il codice dovrebbe essere modificato per usare il nuovo comportamento conforme.

In C++ queste funzioni presentano overload di modello che richiamano le relative controparti più recenti e sicure. Per altre informazioni, vedere Proteggere gli overload dei modelli.

Mapping di routine di testo generico

TCHAR.H routine	_UNICODE e _MBCS non definito	_MBCS definito	_UNICODE definito
_stprintf	sprintf	sprintf	_swprintf
_stprintf_l	_sprintf_l	_sprintf_l	__swprintf_l

Requisiti

Ciclo	Intestazione obbligatoria
sprintf, _sprintf_l	<stdio.h>
swprintf, _swprintf, _swprintf_l	<stdio.h> oppure <wchar.h>

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

Esempio: usare sprintf per formattare i dati

// crt_sprintf.c
// compile with: /W3
// This program uses sprintf to format various
// data and place them in the string named buffer.

#include <stdio.h>

int main( void )
{
   char  buffer[200], s[] = "computer", c = 'l';
   int   i = 35, j;
   float fp = 1.7320534f;

   // Format and print various data:
   j  = sprintf( buffer,     "   String:    %s\n", s ); // C4996
   j += sprintf( buffer + j, "   Character: %c\n", c ); // C4996
   j += sprintf( buffer + j, "   Integer:   %d\n", i ); // C4996
   j += sprintf( buffer + j, "   Real:      %f\n", fp );// C4996
   // Note: sprintf is deprecated; consider using sprintf_s instead

   printf( "Output:\n%s\ncharacter count = %d\n", buffer, j );
}

Output:
   String:    computer
   Character: l
   Integer:   35
   Real:      1.732053

character count = 79

Esempio: Gestione del codice di errore

// crt_swprintf.c
// wide character example
// also demonstrates swprintf returning error code
#include <stdio.h>

int main( void )
{
   wchar_t buf[100];
   int len = swprintf( buf, 100, L"%s", L"Hello world" );
   printf( "wrote %d characters\n", len );
   len = swprintf( buf, 100, L"%s", L"Hello\xffff world" );
   // swprintf fails because string contains WEOF (\xffff)
   printf( "wrote %d characters\n", len );
}

wrote 11 characters
wrote -1 characters

Vedi anche

I/O di flusso
fprintf, _fprintf_l, fwprintf_fwprintf_l
printf, _printf_l, wprintf_wprintf_l
scanf, _scanf_l, wscanf_wscanf_l
sscanf, _sscanf_l, swscanf_swscanf_l
Funzioni vprintf