_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Artykuł
06/09/2015

Formatuje i drukuje do konsoli.Bardziej bezpieczne wersje są dostępne w _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

Ważne
Tego API nie można używać w aplikacjach korzystających ze środowiska wykonawczego Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /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] …
);

Parametry

format
Ciąg formantu formatu.
argument
Parametry opcjonalne.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

Liczba znaków wydrukowanych.

Uwagi

Tefunkcje formatują i drukują szeregi znaków i wartości bezpośrednio do konsoli, za pomocą _putch funkcji (_putwch do _cwprintfznaków danych wyjściowych.Każdy argument (jeśli istnieje) jest konwertowaya i wychodzi według specyfikacji formatu w format.Format ma taką samą formę i funkcjonuje jako format parametr dla printf funkcji.W przeciwieństwie do funkcji fprintf, printf i sprintf, ani _cprintf ani _cwprintf nie tłumaczy znaków przesunięcia o wiersz na kombinacje znaków twardego końca wiersza (CR-LF) podczas drukowania.

Istotna różnica polega na tym, że _cwprintf wyświetla znaki Unicode w systemie Windows NT.W przeciwieństwie do _cprintf, _cwprintf używa bieżących ustawień regionalnych konsoli.

Wersje tych funkcji, które mają przyrostek _l są identyczne, z tą różnicą, że korzystają z przekazanego parametru ustawień regionalnych, zamiast bieżących ustawień regionalnych.

_cprintf sprawdza poprawność parametru format.Jeśli format jest pustym wskaźnikiem, funkcja wywoła procedurę obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, funkcja zwraca wartość -1 i ustawia errno na EINVAL.

Uwaga dotycząca zabezpieczeń
Zapewnienia, że format nie jest ciągiem zdefiniowanym przez użytkownika.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE i _MBCS nie zdefiniowany	_MBCS zdefiniowano	_UNICODE zdefiniowany
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Wymagania

Procedura	Wymagany nagłówek
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

Aby uzyskać więcej informacji na temat zgodności – zobacz: Zgodność.

Przykład

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