_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Artykuł
03/26/2013

Pisanie za pomocą wskaźnika do listy argumentów, z możliwością określić kolejność w którym są używane argumenty sformatowane dane wyjściowe.

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 używane.

Aby uzyskać więcej informacji, zobacz Specyfikacji formatu.

Wartość zwracana

_vprintf_pi _vwprintf_p zwraca liczbę znaków napisane, nie wliczając kończącego znaku null lub wartości ujemnej, jeśli wystąpi błąd danych wyjściowych.

Uwagi

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

_vwprintf_pjest to wersja szerokich znaków _vprintf_p; dwie funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI._vprintf_paktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.

Wersje te funkcje za pomocą _l sufiks są identyczne z tym, że używają przekazany zamiast bieżących ustawień regionalnych wątek parametr ustawień regionalnych.

Uwaga dotycząca zabezpieczeń
Zapewnienia, że format nie jest ciągiem zdefiniowane przez użytkownika.Aby uzyskać więcej informacji, zobacz Unikanie przekroczeniem buforu.

Jeśli format jest pusty wskaźnik, lub jeżeli ciąg formatu zawiera nieprawidłowe znaki formatowania, program obsługi nieprawidłowy parametr jest uruchamiane, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje zwracają wartość -1 i ustawić errno do EINVAL.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE & _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_vtprintf_p	_vprintf_p	_vprintf_p	_vwprintf_p
_vtprintf_p_l	_vprintf_p_l	_vprintf_p_l	_vwprintf_p_l

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka	Nagłówki opcjonalne
_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> *

* Wymagana w przypadku zgodności V systemu UNIX.

Konsola nie jest obsługiwana w Windows Store aplikacji.Związanych z konsolą, dojścia do strumienia standard stdin, stdout, i stderr, muszą być przeniesione, aby funkcje uruchomieniowej C mogą być użyte w Windows Store aplikacji.Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.