_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l

Artykuł
02/27/2013

Zapis sformatowane dane wyjściowe przy użyciu wskaźnika do listy argumentów, z możliwością, aby określić kolejność, że argumenty są używane w ciągu formatu.

int _vfprintf_p(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_p_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vfwprintf_p(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_p_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parametry

stream
Wskaźnik, aby FILE struktury.
format
Specyfikacja formatu.
argptr
Wskaźnik do listy argumentów.
locale
Ustawienia regionalne, aby użyć.

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

Wartość zwracana

_vfprintf_pi _vfwprintf_p zwraca liczbę znaków, napisane, nie włączając kończącego znaku null lub wartości ujemne, 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 dostarczone dane do stream.Funkcje te różnią się od _vfprint_s i _vfwprint_s wersje tylko w tym obsługują one pozycyjne parametrów.Aby uzyskać więcej informacji, zobacz printf_p parametry pozycyjne.

_vfwprintf_pWersja szerokich znaków jest _vprintf_p; dwie funkcje zachowują się identycznie, gdy strumień jest otwierany w trybie ANSI._vprintf_paktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.

Wersje te funkcje, z _l sufiks są identyczne, z wyjątkiem, że używają oni przekazany zamiast bieżące ustawienia regionalne wątku parametr ustawień regionalnych.

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

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

Tekst rodzajowy rutynowych mapowania