_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Artikel
03/12/2013

Stile und Drucken auf der Konsole.Sicherere Versionen sind verfügbar; finden Sie unter _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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

Rückgabewert

Die Anzahl der Zeichen ausgegeben.

Hinweise

Diese Funktionen formatieren und drucken eine Reihe von Zeichen und Werte direkt an die Konsole, mit der _putch-Funktion (_putwch für _cwprintf) zu den Ausgabezeichen.Jedes argument (falls vorhanden) wird und Ausgabe entsprechend der entsprechenden Formatangabe in format konvertiert.Das Format hat die gleiche Form und Funktion wie der format-Parameter für die printf-Funktion.Anders als fprintf, printf und sprintf-Funktionen weder übersetzt _cprintf noch _cwprintf Zeilenvorschubzeichen in Kombinationen von Wagenrücklauf-Zeilenvorschubs (CR-LF), wenn sie ausgegeben werden.

Ein wichtiger Unterschied ist, dass _cwprintf Unicode-Zeichen angezeigt wird, wenn in Windows NT verwendet wird.Anders als _cprintf verwendet _cwprintf die aktuellen Konsolengebietsschemaeinstellungen.

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

_cprintf überprüft den format-Parameter.Wenn format ein NULL-Zeiger ist, ruft die Funktion den ungültigen Parameterhandler auf, 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.

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
_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 Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

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

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufzurufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.