printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

Articolo
03/26/2013

Stampa output formattato nel flusso di output standard.Queste sono versioni di printf, _printf_l, wprintf, _wprintf_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

int printf_s(
   const char *format [,
   argument]... 
);
int _printf_s_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wprintf_s(
   const wchar_t *format [,
   argument]... 
);
int _wprintf_s_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

Parametri

format
Controllo formato.
argument
Argomenti facoltativi.
locale
Le impostazioni locali da utilizzare.

Valore restituito

Restituisce il numero di caratteri stampati o un valore negativo se si verifica un errore.

Note

La funzione printf_s formatta e stampa una serie di caratteri e di valori nel flusso di output standard, stdout.Se gli argomenti seguono il formato stringa, la stringa format deve contenere le specifiche che determinano il formato di output per gli argomenti.

La differenza principale tra printf_s e printf è printf_s che controlla la stringa di formato per i caratteri di formattazione validi, mentre controlli printf solo se la stringa di formato è un puntatore null.Se il controllo non riesce, un gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione può continuare, la funzione restituisce -1 ed imposta errno a EINVAL.

Per informazioni su errno e i codici di errore, vedere _doserrno, errno, _sys_errlist e _sys_nerr.

printf_sefprintf_s si comportano in modo identico con la differenza che printf_s scrivere l'output in stdout anziché una destinazione di tipo FILE.Per ulteriori informazioni, vedere fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

wprintf_s è una versione a caratteri di tipo "wide" di printf_s; in format è una stringa di caratteri di tipo "wide".wprintf_s e printf_s si comportano in modo identico se il flusso viene aperto in modalità ANSI.printf_s non supporta attualmente l'output in un flusso UNICODE.

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

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tprintf_s	printf_s	printf_s	wprintf_s
_tprintf_s_l	_printf_s_l	_printf_s_l	_wprintf_s_l

L'argomento format è costituita da caratteri ordinari, le sequenze di escape e (se gli argomenti seguenti format) le specifiche di formato.I caratteri ordinari e sequenze di escape vengono copiati in stdout per il relativo aspetto.Ad esempio, la riga di comando:

printf_s("Line one\n\t\tLine two\n");

l'output

Line one
        Line two

DiSpecifiche di formato l'inizio sempre con un segno di percentuale (%) e viene letto da sinistra a destra.Quando printf_s incontra la prima specifica il formato (se del caso), che converte il valore del primo argomento dopo format e lo emette di conseguenza.La seconda specifica di formato fa sì che il secondo argomento a essere convertita e a restituita, e così via.Se sono presenti più argomenti che sono specifiche di formato, gli argomenti aggiuntivi vengono ignorati.I risultati vengono definiti se non sono sufficientemente argomenti per tutte le specifiche di formato.

Nota sulla sicurezza
Assicurarsi che format non sia una stringa definita dall'utente.

Requisiti

Routine	Intestazione obbligatoria
printf_s, _printf_s_l	<stdio.h>
wprintf_s, _wprintf_s_l	<stdio.h> o <wchar.h>

La console non è supportata nelle applicazioni di Windows Store.L'handle standard del flusso associate alla console, stdin, stdoute stderr, devono essere reindirizzati prima di funzioni di runtime del linguaggio C possono essere utilizzate nelle applicazioni di Windows Store.Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

// crt_printf_s.c
/* This program uses the printf_s and wprintf_s functions
 * to produce formatted output.
 */

#include <stdio.h>

int main( void )
{
   char   ch = 'h', *string = "computer";
   int    count = -9234;
   double fp = 251.7366;
   wchar_t wch = L'w', *wstring = L"Unicode";

   /* Display integers. */
   printf_s( "Integer formats:\n"
           "   Decimal: %d  Justified: %.6d  Unsigned: %u\n",
           count, count, count );

   printf_s( "Decimal %d as:\n   Hex: %Xh  C hex: 0x%x  Octal: %o\n",
            count, count, count, count );

   /* Display in different radixes. */
   printf_s( "Digits 10 equal:\n   Hex: %i  Octal: %i  Decimal: %i\n",
            0x10, 010, 10 );

   /* Display characters. */

   printf_s("Characters in field (1):\n%10c%5hc%5C%5lc\n", ch, ch, wch, wch);
   wprintf_s(L"Characters in field (2):\n%10C%5hc%5c%5lc\n", ch, ch, wch, wch);

   /* Display strings. */

   printf_s("Strings in field (1):\n%25s\n%25.4hs\n   %S%25.3ls\n",
   string, string, wstring, wstring);
   wprintf_s(L"Strings in field (2):\n%25S\n%25.4hs\n   %s%25.3ls\n",
       string, string, wstring, wstring);

   /* Display real numbers. */
   printf_s( "Real numbers:\n   %f %.2f %e %E\n", fp, fp, fp, fp );

   /* Display pointer. */
   printf_s( "\nAddress as:   %p\n", &count);

}

Esempio di output

Integer formats:
   Decimal: -9234  Justified: -009234  Unsigned: 4294958062
Decimal -9234 as:
   Hex: FFFFDBEEh  C hex: 0xffffdbee  Octal: 37777755756
Digits 10 equal:
   Hex: 16  Octal: 8  Decimal: 10
Characters in field (1):
         h    h    w    w
Characters in field (2):
         h    h    w    w
Strings in field (1):
                 computer
                     comp
   Unicode                      Uni
Strings in field (2):
                 computer
                     comp
   Unicode                      Uni
Real numbers:
   251.736600 251.74 2.517366e+002 2.517366E+002

Address as:   0012FF78