vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

Artykuł
06/09/2015

Zapis sformatowane dane wyjściowe przy użyciu wskaźnika do listy argumentów.Istnieją bardziej bezpiecznych wersji tych funkcji; see vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l.

int vfprintf(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_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

vfprintfi vfwprintf 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.Jeśli albo stream lub format jest wskaźnik zerowy, wywoływana jest funkcja obsługi nieprawidłowy parametr, jak opisano w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje zwracają wartość -1 i errno do EINVAL.

Informacji na temat tych i innych kodów błędów, zobacz _doserrno, errno, _sys_errlist i _sys_nerr.

Uwagi

Każda z tych funkcji ma wskaźnik do listy argumentów, a następnie formatuje i zapisuje dostarczone dane do stream.

vfwprintfWersja szerokich znaków jest vfprintf; dwie funkcje zachowują się identycznie, gdy strumień jest otwierany w trybie ANSI.vfprintfaktualnie 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.