_vprintf_p, , _vprintf_p_l, , _vwprintf_p_vwprintf_p_l

Zapisuje sformatowane dane wyjściowe przy użyciu wskaźnika do listy argumentów i umożliwia określenie kolejności, w której są używane argumenty.

Składnia

int _vprintf_p(
   const char *format,
   va_list argptr
);
int _vprintf_p_l(
   const char *format,
   _locale_t locale,
   va_list argptr
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr
);
int _vwprintf_p_l(
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

Parametry

format
Specyfikacja formatu.

argptr
Wskaźnik do listy argumentów.

locale
Ustawienia regionalne do użycia.

Aby uzyskać więcej informacji, zobacz Składnia specyfikacji formatu.

Wartość zwracana

_vprintf_p i _vwprintf_p zwraca liczbę zapisanych znaków, a nie w tym znak zerowy zakończenia lub wartość ujemną, jeśli wystąpi błąd wyjściowy.

Uwagi

Każda z tych funkcji przyjmuje wskaźnik do listy argumentów, a następnie formatuje i zapisuje dane na .stdout Te funkcje różnią się od vprintf_s i vwprintf_s tylko w tym, że obsługują możliwość określenia kolejności, w jakiej są używane argumenty. Aby uzyskać więcej informacji, zobacz printf_p Parametry pozycyjne.

_vwprintf_p jest wersją _vprintf_po szerokim znaku ; obie funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI. _vprintf_p obecnie nie obsługuje danych wyjściowych do strumienia UNICODE.

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

Ważne

Upewnij się, że format nie jest to ciąg zdefiniowany przez użytkownika. Aby uzyskać więcej informacji, zobacz Unikanie przekroków buforu. 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".

Jeśli format jest wskaźnikiem o wartości null lub jeśli ciąg formatu zawiera nieprawidłowe znaki formatowania, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie 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
_vtprintf_p	_vprintf_p	_vprintf_p	_vwprintf_p
_vtprintf_p_l	_vprintf_p_l	_vprintf_p_l	_vwprintf_p_l

Wymagania

Procedura	Wymagany nagłówek	Opcjonalne nagłówki
_vprintf_p, _vprintf_p_l	<stdio.h> i <stdarg.h>	<varargs.h>*
_vwprintf_p, _vwprintf_p_l	<stdio.h> lub <wchar.h>, i <stdarg.h>	<varargs.h>*

* Wymagane do zachowania zgodności z systemem UNIX V.

Konsola nie jest obsługiwana w aplikacjach platformy platforma uniwersalna systemu Windows (UWP). Standardowe dojścia strumienia skojarzone z konsolą programu stdin, stdouti i stderrmuszą zostać przekierowane, zanim funkcje czasu wykonywania języka C będą mogły ich używać w aplikacjach platformy UWP. Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Zobacz też

We/Wy strumienia
vprintf, funkcje
_fprintf_p, , _fprintf_p_l, , _fwprintf_p_fwprintf_p_l
_printf_p, , _printf_p_l, , _wprintf_p_wprintf_p_l
_sprintf_p, , _sprintf_p_l, , _swprintf_p_swprintf_p_l
vsprintf_s, , _vsprintf_s_l, , vswprintf_s_vswprintf_s_l
va_arg, , va_copy, , va_endva_start
_vfprintf_p, , _vfprintf_p_l, , _vfwprintf_p_vfwprintf_p_l
_printf_p, , _printf_p_l, , _wprintf_p_wprintf_p_l
printf_p Parametry pozycyjne