_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Artikel
06/09/2015

Formatiert und druckt in die Konsole. Sicherere Versionen sind verfügbar. Informationen dazu finden Sie unter _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.

int _cprintf( 
   const char * format [, 
   argument] ... 
);
int _cprintf_l( 
   const char * format,
   locale_t locale [,
   argument] … 
);
int _cwprintf(
   const wchar * format [, 
   argument] …
);
int _cwprintf_l(
   const wchar * format,
   locale_t locale [, 
   argument] …
);

Parameter

format
Formatsteuerzeichenfolge.
argument
Optionale Parameter.
locale
Das zu verwendende Gebietsschema.

Rückgabewert

Die Anzahl der zu gedruckten Zeichen.

Hinweise

Diese -Funktionen formatieren und drucken eine Reihe von Zeichen und Werte direkt an die Konsole, mithilfe der _putch-Funktion (_putwch für _cwprintf) zu den Ausgabezeichen. Jedes argument (falls vorhanden) wird entsprechend der jeweiligen Formatangabe in format konvertiert und ausgegeben. Das Format hat dieselbe Form und Funktion wie der format-Parameter für die printf-Funktion. Anders als die fprintf-, printf- und sprintf-Funktionen übersetzen weder _cprintf noch _cwprintf Zeilenvorschubzeichen bei der Ausgabe in eine Kombination aus Wagenrücklauf und Zeilenvorschub (CR-LF).

Ein wichtiger Unterschied ist, dass _cwprintf bei der Verwendung in Windows NT Unicode-Zeichen anzeigt. Anders als _cprintf verwendet _cwprintf die aktuellen Einstellungen des Konsolengebietsschemas.

Die Versionen dieser Funktionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch den ihnen übergebenen Gebietsschemaparameter anstelle des aktuellen Gebietsschemas.

_cprintf überprüft den format-Parameter. Wenn format ein NULL-Zeiger ist, dann ruft die Funktion den Handler für ungültige Parameter auf, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt die Funktion – 1 zurück und stellt errno auf EINVAL ein.

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

Zuordnung generischer Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Anforderungen

Routine	Erforderlicher Header
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

// crt_cprintf.c
// compile with: /c
// This program displays some variables to the console.

#include <conio.h>

int main( void )
{
    int         i = -16,
                h = 29;
    unsigned    u = 62511;
    char        c = 'A';
    char        s[] = "Test";

    // Note that console output does not translate \n as
    // standard output does. Use \r\n instead.
    //
    _cprintf( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}