Delen via

_vfprintf_p,_vfprintf_p_l,_vfwprintf_p,_vfwprintf_p_l

Schrijf opgemaakte uitvoer met behulp van een aanwijzer naar een lijst met argumenten, met de mogelijkheid om de volgorde op te geven waarin argumenten worden gebruikt in de notatietekenreeks.

Syntaxis

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

Parameterwaarden

stream
Aanwijzer naar FILE structuur.

format
Formaat specificatie.

argptr
Aanwijzer naar de lijst met argumenten.

locale
De landinstelling die moet worden gebruikt.

Zie Specificatiesyntaxis opmaken voor meer informatie.

Retourwaarde

_vfprintf_p en _vfwprintf_p retourneert het aantal geschreven tekens, niet inclusief het null-teken beëindigen of een negatieve waarde als er een uitvoerfout optreedt.

Opmerkingen

Elk van deze functies neemt een aanwijzer naar een lijst met argumenten en maakt vervolgens de opgegeven gegevens op en schrijft deze naar stream. Deze functies verschillen alleen van de _vfprint_s en _vfwprint_s versies omdat ze positionele parameters ondersteunen. Zie printf_p Positieparameters voor meer informatie.

_vfwprintf_p is de brede versie van _vprintf_p; de twee functies gedragen zich identiek als de stream wordt geopend in de ANSI-modus. _vprintf_p ondersteunt momenteel geen uitvoer in een UNICODE-stream.

De versies van deze functies met het _l achtervoegsel zijn identiek, behalve dat ze de locale-parameter gebruiken die wordt doorgegeven in plaats van de huidige thread-locale.

Belangrijk

Zorg ervoor dat dit format geen door de gebruiker gedefinieerde tekenreeks is. Zie Bufferoverschrijdingen voorkomen voor meer informatie. Vanaf Windows 10 versie 2004 (build 19041) drukt de printf reeks functies exact vertegenwoordigbare zwevende kommanummers af volgens de IEEE 754-regels voor afronding. In eerdere versies van Windows zouden de zwevende kommanummers die eindigen op '5' altijd naar boven afronden. IEEE 754 geeft aan dat ze moeten afronden op het dichtstbijzijnde even cijfer (ook wel bekend als 'Afronding van bankier'). Beide moeten bijvoorbeeld printf("%1.0f", 1.5)printf("%1.0f", 2.5) worden afgerond op 2. Voorheen zou 1,5 afronden op 2 en 2,5 naar 3. Deze wijziging is alleen van invloed op exact vertegenwoordigbare getallen. Bijvoorbeeld: 2.35 (die, wanneer deze wordt weergegeven in het geheugen, dichter bij 2.350000000000008) blijft afronden tot 2,4. Afronding die door deze functies wordt uitgevoerd, respecteert nu ook de drijvende-komma-afrondingsmodus die is ingesteld door fesetround. Eerder koos afronding altijd voor FE_TONEAREST gedrag. Deze wijziging is alleen van invloed op programma's die zijn gebouwd met Visual Studio 2019 versie 16.2 en hoger. Als u het verouderde drijvendekomma-afrondingsgedrag wilt gebruiken, moet u een koppeling maken met legacy_stdio_float_rounding.obj.

Als een stream null-aanwijzer is of format als de notatietekenreeks ongeldige opmaaktekens bevat, wordt de ongeldige parameterhandler aangeroepen, zoals beschreven in parametervalidatie. Als de uitvoering mag doorgaan, keren de functies terug -1 en worden ze ingesteld errno op EINVAL.

Algemene routinetoewijzingen voor tekst

TCHAR. H-routine _UNICODE en _MBCS niet gedefinieerd _MBCS Gedefinieerd _UNICODE Gedefinieerd
_vftprintf_p _vfprintf_p _vfprintf_p _vfwprintf_p
_vftprintf_p_l _vfprintf_p_l _vfprintf_p_l _vfwprintf_p_l

Behoeften

Routine Vereiste header Optionele headers
_vfprintf_p, _vfprintf_p_l <stdio.h> en <stdarg.h> <varargs.h>*
_vfwprintf_p, _vfwprintf_p_l <stdio.h> of <wchar.h>, en <stdarg.h> <varargs.h>*

* Vereist voor UNIX V-compatibiliteit.

Zie Compatibiliteit voor meer compatibiliteitsinformatie.

Zie ook

Stream I/O-
vprintf functies
fprintf, , , _fprintf_lfwprintf_fwprintf_l
printf, , , _printf_lwprintf_wprintf_l
sprintf swprintf, _sprintf_l, _swprintf_l__swprintf_l
va_arg, , , va_copyva_endva_start
printf_p positionele parameters
_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

  • Last updated on