Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

1 von 1 fanden dies hilfreich - Dieses Thema bewerten.

printf, _printf_l, wprintf, _wprintf_l

Visual Studio 2012

Andere Versionen

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 zu verwendende Gebietsschema .

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 fortgesetzt werden darf, gibt die Funktion -1 zurück und setzt errno auf den Wert EINVAL. 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 der Konsole, stdin, stdout und stderr zugeordnet sind, müssen umgeleitet werden, bevor die C-Laufzeitfunktionen sie in Windows Store-App verwenden. Weitere Informationen zur Kompatibilität 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

.NET Framework-Entsprechung