_sprintf_p
, _sprintf_p_l
, _swprintf_p
_swprintf_p_l
Scrivere dati formattati su una stringa con la possibilità di specificare l'ordine dei parametri utilizzati nella stringa di formato.
Sintassi
int _sprintf_p(
char *buffer,
size_t sizeOfBuffer,
const char *format [,
argument_list]
);
int _sprintf_p_l(
char *buffer,
size_t sizeOfBuffer,
const char *format,
_locale_t locale [,
argument_list]
);
int _swprintf_p(
wchar_t *buffer,
size_t sizeOfBuffer,
const wchar_t *format [,
argument_list]
);
int _swprintf_p_l(
wchar_t *buffer,
size_t sizeOfBuffer,
const wchar_t *format,
_locale_t locale [,
argument_list]
);
Parametri
buffer
Percorso di archiviazione per l'output
sizeOfBuffer
Numero massimo di caratteri da archiviare.
format
Stringa di controllo del formato.
argument_list
Argomenti facoltativi per la stringa di formato.
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.
Osservazioni:
La funzione _sprintf_p
formatta e archivia una serie di caratteri e di valori in buffer
. Ogni argomento nell'oggetto argument_list
(se presente) viene convertito e restituito in base alla specifica di formato corrispondente in format
. L'argomento format
usa la sintassi della specifica del formato per printf
le funzioni e wprintf
. 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 tra _sprintf_p
e sprintf_s
è che _sprintf_p
supporta i parametri posizionali, che consentono di specificare l'ordine in cui gli argomenti vengono utilizzati nella stringa di formato. Per altre informazioni, vedere printf_p
Parametri posizionali.
_swprintf_p
è una versione a caratteri "wide" di _sprintf_p
. Gli argomenti puntatori per _swprintf_p
sono stringhe a caratteri "wide". Il rilevamento degli errori di codifica in _swprintf_p
può differire dal rilevamento in _sprintf_p
. _swprintf_p
e fwprintf_p
si comportano in modo identico con la differenza che _swprintf_p
scrive l'output in una stringa anziché in una destinazione di tipo FILE
e _swprintf_p
richiede il parametro count
per specificare il numero massimo di caratteri da scrivere. 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.
_sprintf_p
restituisce il numero di byte archiviato in buffer
, senza contare il carattere Null terminale. _swprintf_p
restituisce il numero di caratteri "wide" archiviati in buffer
, senza contare il carattere "wide" Null finale. Se buffer
o format
è un puntatore Null o se la stringa di formato contiene caratteri di formattazione non validi, 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
.
Importante
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".
Mapping di routine di testo generico
TCHAR.H routine |
_UNICODE e _MBCS non definito |
_MBCS definito |
_UNICODE definito |
---|---|---|---|
_stprintf_p |
_sprintf_p |
_sprintf_p |
_swprintf_p |
_stprintf_p_l |
_sprintf_p_l |
_sprintf_p_l |
_swprintf_p_l |
Requisiti
Ciclo | Intestazione obbligatoria |
---|---|
_sprintf_p , _sprintf_p_l |
<stdio.h> |
_swprintf_p , _swprintf_p_l |
<stdio.h> oppure <wchar.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).
Esempio: usare _sprintf_p
per formattare i dati
// crt_sprintf_p.c
// This program uses _sprintf_p 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_p( buffer, 200,
" String: %s\n", s );
j += _sprintf_p( buffer + j, 200 - j,
" Character: %c\n", c );
j += _sprintf_p( buffer + j, 200 - j,
" Integer: %d\n", i );
j += _sprintf_p( buffer + j, 200 - j,
" Real: %f\n", fp );
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_p.c
// This is the wide character example which
// also demonstrates _swprintf_p returning
// error code.
#include <stdio.h>
#define BUFFER_SIZE 100
int main( void )
{
wchar_t buffer[BUFFER_SIZE];
int len;
len = _swprintf_p(buffer, BUFFER_SIZE, L"%2$s %1$d",
0, L" marbles in your head.");
_printf_p( "Wrote %d characters\n", len );
// _swprintf_p fails because string contains WEOF (\xffff)
len = _swprintf_p(buffer, BUFFER_SIZE, L"%s",
L"Hello\xffff world" );
_printf_p( "Wrote %d characters\n", len );
}
Wrote 24 characters
Wrote -1 characters
Vedi anche
I/O di flusso
_fprintf_p
, _fprintf_p_l
, _fwprintf_p
_fwprintf_p_l
fprintf
, _fprintf_l
, fwprintf
_fwprintf_l
_printf_p
, _printf_p_l
, _wprintf_p
_wprintf_p_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
sscanf_s
, _sscanf_s_l
, swscanf_s
_swscanf_s_l
Funzioni vprintf
printf_p
Parametri posizionali