_cprintf_s, , _cprintf_s_l, , _cwprintf_s_cwprintf_s_l

Formatuje i drukuje w konsoli programu . Te wersje programu _cprintf, _cwprintf_cprintf_l _cwprintf_l, mają ulepszenia zabezpieczeń zgodnie z opisem w temacie Funkcje zabezpieczeń w narzędziu CRT.

Ważne

Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

int _cprintf_s(
   const char * format [,
   argument] ...
);
int _cprintf_s_l(
   const char * format,
   _locale_t locale [,
   argument] ...
);
int _cwprintf_s(
   const wchar * format [,
   argument] ...
);
int _cwprintf_s_l(
   const wchar * format,
   _locale_t locale [,
   argument] ...
);

Parametry

format
Ciąg kontroli formatu.

argument
Parametry opcjonalne.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Liczba drukowanych znaków.

Uwagi

Te funkcje formatować i drukować serię znaków i wartości bezpośrednio w konsoli przy użyciu _putch funkcji (_putwch for _cwprintf_s) do znaków wyjściowych. Każda argument (jeśli istnieje) jest konwertowana i wyjściowa zgodnie z odpowiednią specyfikacją formatu w pliku format. Format ma ten sam formularz i funkcję co format parametr funkcji printf_s . fprintf_sW przeciwieństwie do funkcji _cprintf_s _cwprintf_s , printf_si sprintf_s nie tłumacz znaków zestawienia wierszy na kombinacje zestawienia powrotu karetki (CR-LF) podczas danych wyjściowych.

Ważne rozróżnienie polega na _cwprintf_s wyświetlaniu znaków Unicode w przypadku użycia w systemie Windows NT. W przeciwieństwie do _cprintf_sprogramu _cwprintf_s używa bieżących ustawień regionalnych konsoli

Wersje tych funkcji z sufiksem _l są identyczne, z tą różnicą, że używają parametru ustawień regionalnych przekazanych zamiast bieżących ustawień regionalnych.

Ważne

Upewnij się, że format nie jest to ciąg zdefiniowany przez użytkownika.

Począwszy od systemu Windows 10 w wersji 2004 (kompilacja 19041), printf rodzina funkcji drukuje dokładnie możliwe liczby zmiennoprzecinkowe zgodnie z regułami IEEE 754 dotyczącymi zaokrąglania. W poprzednich wersjach systemu Windows dokładnie reprezentowane liczby zmiennoprzecinkowe kończące się na "5" zawsze zaokrągla się w górę. IEEE 754 stwierdza, że muszą zaokrąglić do najbliższej parzysta cyfra (znana również jako "Zaokrąglanie Bankiera"). Na przykład oba printf("%1.0f", 1.5) printf("%1.0f", 2.5) elementy i powinny być zaokrąglone do 2. Wcześniej 1,5 zaokrągliłoby się do 2 i 2,5 do 3. Ta zmiana dotyczy tylko dokładnie możliwych do reprezentowania liczb. Na przykład 2,35 (który, gdy jest reprezentowany w pamięci, jest bliżej 2,350000000000000008) nadal zaokrągla się do 2,4. Zaokrąglanie wykonywane przez te funkcje jest teraz również zgodne z trybem zaokrąglania zmiennoprzecinkowego ustawionym przez fesetround. Wcześniej zaokrąglanie zawsze wybierało FE_TONEAREST zachowanie. Ta zmiana dotyczy tylko programów utworzonych przy użyciu programu Visual Studio 2019 w wersji 16.2 lub nowszej. Aby użyć starszego zachowania zaokrąglania zmiennoprzecinkowego, połącz się z elementem "legacy_stdio_float_rounding.obj".

Podobnie jak w przypadku wersji niezabezpieczonych (zobacz _cprintf, _cprintf_l, _cwprintf, _cwprintf_l), te funkcje weryfikują parametry i wywołują nieprawidłową procedurę obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów, jeśli format jest wskaźnikiem o wartości null. Te funkcje różnią się od niezabezpieczonych wersji w tym, że sam ciąg formatu jest również weryfikowany. Jeśli istnieją jakiekolwiek nieznane lub nieprawidłowo sformułowane specyfikatory formatowania, te funkcje wywołują nieprawidłową procedurę obsługi parametrów. We wszystkich przypadkach, jeśli wykonanie jest dozwolone do kontynuowania, funkcje zwracają wartość -1 i ustawiają wartość errno EINVAL.

Mapowania procedur tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS zdefiniowany	_UNICODE zdefiniowany
_tcprintf_s	_cprintf_s	_cprintf_s	_cwprintf_s
_tcprintf_s_l	_cprintf_s_l	_cprintf_s_l	_cwprintf_s_l

Wymagania

Procedura	Wymagany nagłówek
_cprintf_s, _cprintf_s_l	<conio.h>
_cwprintf_s, _cwprintf_s_l	<conio.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka C.

Przykład

// crt_cprintf_s.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_s( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}

-16  001d  62511  A Test

Zobacz też

We/Wy konsoli i portu
_cscanf, , _cscanf_l, , _cwscanf_cwscanf_l
fprintf_s, , _fprintf_s_l, , fwprintf_s_fwprintf_s_l
printf_s, , _printf_s_l, , wprintf_s_wprintf_s_l
sprintf_s, , _sprintf_s_l, , swprintf_s_swprintf_s_l
vfprintf_s, , _vfprintf_s_l, , vfwprintf_s_vfwprintf_s_l
Składnia specyfikacji formatu: printf i wprintf funkcje