_printf_s_l, wie, wprintf_s, _wprintf_s_l

Artikel
03/12/2013

Drucken formatierte Ausgabe den Standardausgabestream.Diese sind Versionen von printf, _printf_l, wprintf, _wprintf_l mit Sicherheitserweiterungen, wie in Sicherheitsfeatures im CRT beschrieben.

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]... );

Parameter

format
Formatsteuerelement.
argument
Optionale Argumente.
locale
Das Gebietsschema zu verwenden.

Rückgabewert

Gibt die Anzahl der gedruckten Zeichen oder einen negativen Wert zurück, wenn ein Fehler auftritt.

Hinweise

Die printf_s-Funktion formatiert und gibt eine Reihe von Zeichen und Werte den Standardausgabestream, stdout.Wenn Argumente der Formatzeichenfolge folgen, muss die Zeichenfolge format Spezifikation enthalten, die das Ausgabeformat für die Argumente bestimmen.

Der Hauptunterschied zwischen printf_s und printf ist, dass printf_s die Formatzeichenfolge für gültige Formatierungszeichen überprüft, während Überprüfungen printf nur, wenn die Formatzeichenfolge ein NULL-Zeiger ist.Wenn jede Überprüfung fehlschlägt, wird ein ungültiger Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, gibt die Funktion -1 zurück und legt errno zu EINVAL fest.

Informationen zum errno und Fehlercodes, finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

printf_s und fprintf_s verhalten sich identisch, außer dass printf_s schreibt stdout Ausgabe statt auf einem Ziel des Typs FILE.Weitere Informationen finden Sie unter fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

wprintf_s ist eine Breitzeichen-Version von printf_s; format ist eine Zeichenfolge mit Breitzeichen.wprintf_s und printf_s verhalten sich identisch, wenn der Stream in ANSI-Modus geöffnet ist.printf_s nicht unterstützt Ausgabe in einen UNICODE-Stream.

Die Versionen dieser Funktionen mit dem _l Suffix sind identisch, allerdings verwenden den Gebietsschemaparameter in, der anstelle des aktuellen Threadgebietsschemas übergeben wird.

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert.	_MBCS definiert	_unicode definiert
_tprintf_s	printf_s	printf_s	wprintf_s
_tprintf_s_l	_printf_s_l	_printf_s_l	_wprintf_s_l

Das format-Argument besteht normalen Zeichen, Escapesequenzen und (wenn Argumente format folgen), Formatangaben aus.Die normalen Zeichen und die Escapesequenzen werden zu stdout in der Reihenfolge ihrer Darstellung kopiert.Beispiel: Die Zeile:

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

erzeugt die Ausgabe

Line one
        Line two

Formatangaben immer beginnen mit einem Prozentzeichen (%) und werden von links nach rechts gelesen.Wenn printf_s die erste Formatangabe (falls vorhanden) trifft, konvertiert sie den Wert des ersten Arguments nach format und gibt ihn entsprechend aus.Die zweite Formatangabe wird das zweite Argument konvertiert werden und Ausgabe, u. a.Wenn mehrere Argumente gibt, als es Formatangaben gibt, werden die zusätzlichen Argumente ignoriert.Die Ergebnisse werden definiert, wenn nicht genügend Argumente für alle Formatangaben gibt.

Sicherheitshinweis
Stellen Sie sicher, dass format keine benutzerdefinierte Zeichenfolge ist.

Anforderungen

Routine	Erforderlicher Header
printf_s, _printf_s_l	<stdio.h>
wprintf_s, _wprintf_s_l	<stdio.h> oder <wchar.h>

Die Konsole wird nicht in Windows Store-App unterstützt.Die Standardstreamhandles, die mit der Konsole, stdin, stdout und stderr zugeordnet werden, müssen umgeleitet werden, bevor sie C-Laufzeitfunktionen in Windows Store-App verwenden können.So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

// 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);

}

Beispielausgabe

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