_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.

Mapping di routine di testo generico

Requisiti

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