printf, _printf_l, wprintf, _wprintf_l

Artikel
03/12/2013

Drucken formatierte Ausgabe den Standardausgabestream.Sicherere Versionen dieser Funktionen sind verfügbar; finden Sie unter _printf_s_l, wie, wprintf_s, _wprintf_s_l.

int printf( const char *format [, argument]... ); int _printf_l( const char *format, locale_t locale [, argument]... ); int wprintf( const wchar_t *format [, argument]... ); int _wprintf_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.Wenn formatNULL ist, wird der ungültige 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.Wenn EOF (0xFFFF) in argument auftritt, Funktionsrückgaben -1.

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

Hinweise

Die printf-Funktion formatiert und gibt eine Reihe von Zeichen und Werte den Standardausgabestream, stdout.Wenn Argumente der format Zeichenfolge ausführen, muss die Zeichenfolge format Spezifikation enthalten, die das Ausgabeformat für die Argumente bestimmen.printf und fprintf verhalten sich identisch, außer dass printf schreibt stdout Ausgabe statt auf einem Ziel des Typs FILE.

wprintf ist eine Breitzeichen-Version von printf; format ist eine Zeichenfolge mit Breitzeichen.wprintf und printf verhalten sich identisch, wenn der Stream in ANSI-Modus geöffnet ist.printf 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	printf	printf	wprintf

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.Beispielsweise die Zeile:

printf("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 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.

Zuordnung generische Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tprintf	printf	printf	wprintf
_tprintf_l	_printf_l	_printf_l	_wprintf_l

Anforderungen

Routine	Erforderlicher Header
printf, _printf_l	<stdio.h>
wprintf, _wprintf_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.c
// This program uses the printf and wprintf functions
// to produce formatted output.

#include <stdio.h>

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

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

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

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

   // Display characters
   printf("Characters in field (1):\n"
          "%10c%5hc%5C%5lc\n",
          ch, ch, wch, wch);
   wprintf(L"Characters in field (2):\n"
           L"%10C%5hc%5c%5lc\n",
           ch, ch, wch, wch);

   // Display strings
   printf("Strings in field (1):\n%25s\n"
          "%25.4hs\n   %S%25.3ls\n",
          string, string, wstring, wstring);
   wprintf(L"Strings in field (2):\n%25S\n"
           L"%25.4hs\n   %s%25.3ls\n",
           string, string, wstring, wstring);

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

   // Display pointer
   printf( "\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:   0012FF3C