sprintf_s, _sprintf_s_l, swprintf_s_swprintf_s_l

Scrivere dati formattati in una stringa. Queste funzioni sono versioni di , , , , , __swprintf_l con miglioramenti della sicurezza, come descritto in Funzionalità di sicurezza in CRT. _swprintf_lswprintf_sprintf_lsprintf

Sintassi

int sprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format,
   ...
);
int _sprintf_s_l(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format,
   _locale_t locale,
   ...
);
int swprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format,
   ...
);
int _swprintf_s_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format,
   _locale_t locale,
   ...
);
template <size_t size>
int sprintf_s(
   char (&buffer)[size],
   const char *format,
   ...
); // C++ only
template <size_t size>
int swprintf_s(
   wchar_t (&buffer)[size],
   const wchar_t *format,
   ...
); // C++ only

Parametri

buffer
Percorso di archiviazione per l'output

sizeOfBuffer
Numero massimo di caratteri da archiviare.

format
Stringa di controllo del formato

...
Argomenti facoltativi da formattare

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, sprintf_s e swprintf_s restituiscono -1 e impostano errno su EINVAL.

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

Osservazioni:

La funzione sprintf_s 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.

La differenza principale tra sprintf_s e sprintf è che sprintf_s controlla la stringa di formato per i caratteri di formattazione validi, mentre sprintf controlla solo se la stringa di formato o il buffer è un puntatore NULL . Se uno dei controlli ha esito negativo, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno su EINVAL.

Un'altra differenza principale tra sprintf_s e sprintf è che sprintf_s accetta un parametro di lunghezza che specifica la dimensione del buffer di output in caratteri. Se il buffer è troppo piccolo per il testo formattato, incluso il carattere di terminazione Null, il buffer viene impostato su una stringa vuota inserendo un carattere Null in buffer[0]e viene richiamato il gestore di parametro non valido. A differenza di _snprintf, sprintf_s garantisce che il buffer avrà una terminazione Null, a meno che le dimensioni del buffer non siano zero.

swprintf_s è una versione a caratteri "wide" di sprintf_s. Gli argomenti puntatori per swprintf_s sono stringhe a caratteri "wide". Il rilevamento degli errori di codifica in swprintf_s può differire dal rilevamento in sprintf_s. 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.

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

Esistono versioni di sprintf_s che offrono un maggiore controllo su cosa accade se il buffer è troppo piccolo. Per altre informazioni, vedere _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l.

Mapping di routine di testo generico

Requisiti

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

Esempio: usare sprintf_s per formattare i dati

// crt_sprintf_s.c
// This program uses sprintf_s 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_s( buffer, 200,     "   String:    %s\n", s );
   j += sprintf_s( buffer + j, 200 - j, "   Character: %c\n", c );
   j += sprintf_s( buffer + j, 200 - j, "   Integer:   %d\n", i );
   j += sprintf_s( buffer + j, 200 - j, "   Real:      %f\n", fp );

   printf_s( "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_s.c
// wide character example
// also demonstrates swprintf_s returning error code
#include <stdio.h>

int main( void )
{
   wchar_t buf[100];
   int len = swprintf_s( buf, 100, L"%s", L"Hello world" );
   printf( "wrote %d characters\n", len );
   len = swprintf_s( buf, 100, L"%s", L"Hello\xffff world" );
   // swprintf_s 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
sprintf, _sprintf_l, swprintf, _swprintf_l__swprintf_l
scanf, _scanf_l, wscanf_wscanf_l
sscanf, _sscanf_l, swscanf_swscanf_l
Funzioni vprintf