Dela via

_vfprintf_p, _vfprintf_p_l, , _vfwprintf_p_vfwprintf_p_l

Skriv formaterade utdata med hjälp av en pekare till en lista med argument, med möjlighet att ange den ordning som argumenten används i formatsträngen.

Syntax

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
);

Parameterar

stream
Pekare till FILE struktur.

format
Specifikation av format.

argptr
Pekare till en lista med argument.

locale
Språkvarianten som ska användas.

Mer information finns i Syntax för formatspecifikation.

Returvärde

_vfprintf_p och _vfwprintf_p returnera antalet tecken som skrivits, inklusive det avslutande null-tecknet eller ett negativt värde om ett utdatafel inträffar.

Anmärkningar

Var och en av dessa funktioner tar en pekare till en argumentlista, formaterar och skriver sedan angivna data till stream. Dessa funktioner skiljer sig från versionerna _vfprint_s och _vfwprint_s endast på så sätt att de stöder positionsparametrar. Mer information finns i printf_p Positionsparametrar.

_vfwprintf_p är wide-character-versionen av _vprintf_p; de två funktionerna fungerar identiskt om strömmen öppnas i ANSI-läge. _vprintf_p stöder för närvarande inte utdata till en UNICODE-ström.

Versionerna av dessa funktioner med suffixet _l är identiska, förutom att de använder parametern locale som skickas i stället för den aktuella trådspråkinställningen.

Viktigt!

Kontrollera att det format inte är en användardefinierad sträng. Mer information finns i Undvika buffertöverskridningar. Från och med Windows 10 version 2004 (version 19041) skriver funktionsfamiljen printf ut exakt representerande flyttalsnummer enligt IEEE 754-reglerna för avrundning. I tidigare versioner av Windows skulle exakt representerande flyttalsnummer som slutar på "5" alltid avrunda uppåt. IEEE 754 anger att de måste avrunda till den närmaste jämna siffran (även kallat "Bankers avrundning"). Till exempel bör både printf("%1.0f", 1.5) och printf("%1.0f", 2.5) avrunda till 2. Tidigare skulle 1,5 avrunda till 2 och 2,5 skulle avrunda till 3. Den här ändringen påverkar endast exakt representerande tal. Till exempel fortsätter 2.35 (som, när det representeras i minnet, är närmare 2.3500000000000000008) att avrunda upp till 2,4. Avrundning som utförs av dessa funktioner respekterar nu också flyttalsrundningsläget som anges av fesetround. Tidigare valde FE_TONEAREST avrundning alltid beteende. Den här ändringen påverkar endast program som skapats med Visual Studio 2019 version 16.2 och senare. Om du vill använda det äldre avrundningsbeteendet för flyttalser länkar du till legacy_stdio_float_rounding.obj.

Om antingen stream eller format är en null-pekare, eller om formatsträngen innehåller ogiltiga formateringstecken, anropas den ogiltiga parameterhanteraren enligt beskrivningen i Parameterverifiering. Om körningen tillåts fortsätta returnerar funktionerna -1 och ställs in errno på EINVAL.

Allmän textrutinmappning

TCHAR. H-rutin _UNICODE och _MBCS inte definierad _MBCS definierad _UNICODE definierad
_vftprintf_p _vfprintf_p _vfprintf_p _vfwprintf_p
_vftprintf_p_l _vfprintf_p_l _vfprintf_p_l _vfwprintf_p_l

Kravspecifikation

Rutin Obligatoriskt huvud Valfria rubriker
_vfprintf_p, _vfprintf_p_l <stdio.h> och <stdarg.h> <varargs.h>*
_vfwprintf_p, _vfwprintf_p_l <stdio.h> eller <wchar.h> och <stdarg.h> <varargs.h>*

* Krävs för UNIX V-kompatibilitet.

Mer kompatibilitetsinformation finns i Kompatibilitet.

Se även

Strömma I/O
vprintf funktioner
fprintf, _fprintf_l, , fwprintf_fwprintf_l
printf, _printf_l, , wprintf_wprintf_l
sprintf, _sprintf_l, swprintf, , , _swprintf_l__swprintf_l
va_arg, va_copy, , va_endva_start
printf_p positionsparametrar
_fprintf_p, _fprintf_p_l, , _fwprintf_p_fwprintf_p_l
_vsprintf_p, _vsprintf_p_l, , _vswprintf_p_vswprintf_p_l
_sprintf_p, _sprintf_p_l, , _swprintf_p_swprintf_p_l