_vscprintf_p, , _vscprintf_p_l, , _vscwprintf_p_vscwprintf_p_l

Zwraca liczbę znaków w sformatowanym ciągu przy użyciu wskaźnika do listy argumentów, z możliwością określenia kolejności, w której są używane argumenty.

Składnia

int _vscprintf_p(
   const char *format,
   va_list argptr
);
int _vscprintf_p_l(
   const char *format,
   _locale_t locale,
   va_list argptr
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr
);
int _vscwprintf_p_l(
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

Parametry

format
Ciąg kontroli 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

_vscprintf_p Zwraca liczbę znaków, które byłyby generowane, jeśli ciąg wskazywany przez listę argumentów został wydrukowany lub wysłany do pliku lub buforu przy użyciu określonych kodów formatowania. Zwrócona wartość nie zawiera znaku null zakończenia. _vscwprintf_p wykonuje tę samą funkcję dla znaków szerokich.

Uwagi

Te funkcje różnią się od _vscprintf i _vscwprintf 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.

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.

Jeśli format jest wskaźnikiem o wartości null, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Walidacja parametru. Jeśli wykonywanie jest dozwolone do kontynuowania, funkcje zwracają wartość -1 i ustawiają wartość errnoEINVAL.

Ważne

Upewnij się, że jeśli format jest ciągiem zdefiniowanym przez użytkownika, jest zakończony o wartości null i ma poprawną liczbę i typ parametrów. 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".

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_vsctprintf_p	_vscprintf_p	_vscprintf_p	_vscwprintf_p
_vsctprintf_p_l	_vscprintf_p_l	_vscprintf_p_l	_vscwprintf_p_l

Wymagania

Procedura	Wymagany nagłówek
_vscprintf_p, _vscprintf_p_l	<stdio.h>
_vscwprintf_p, _vscwprintf_p_l	<stdio.h> lub <wchar.h>

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

Przykład

Zobacz przykład dla elementu vsprintf.

Zobacz też

vprintf, funkcje
_scprintf_p, , _scprintf_p_l, , _scwprintf_p_scwprintf_p_l
_vscprintf, , _vscprintf_l, , _vscwprintf_vscwprintf_l