Delen via

vfprintf_s,_vfprintf_s_l,vfwprintf_s,_vfwprintf_s_l

Schrijf geformatteerde uitvoer met behulp van een aanwijzer naar een lijst met argumenten. Deze functies zijn versies van vfprintf, _vfprintf_l, vfwprintf_vfwprintf_l met beveiligingsverbeteringen zoals beschreven in beveiligingsfuncties in de CRT.

Syntaxis

int vfprintf_s(
   FILE *stream,
   const char *format,
   va_list argptr
);
int _vfprintf_s_l(
   FILE *stream,
   const char *format,
   _locale_t locale,
   va_list argptr
);
int vfwprintf_s(
   FILE *stream,
   const wchar_t *format,
   va_list argptr
);
int _vfwprintf_s_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_s en vfwprintf_s retourneert het aantal geschreven tekens, niet inclusief het null-teken beëindigen of een negatieve waarde als er een uitvoerfout optreedt. 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.

Zie voor informatie over deze en andere foutcodes , errno,_doserrno , _sys_errlisten _sys_nerr.

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 niet-beveiligde versies omdat de beveiligde versies controleren of de format tekenreeks geldige opmaaktekens bevat.

vfwprintf_s is de brede versie van vfprintf_s; de twee functies gedragen zich identiek als de stream wordt geopend in de ANSI-modus. vfprintf_s 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.

Algemene routinetoewijzingen voor tekst

TCHAR. H-routine _UNICODE en _MBCS niet gedefinieerd _MBCS Gedefinieerd _UNICODE Gedefinieerd
_vftprintf_s vfprintf_s vfprintf_s vfwprintf_s
_vftprintf_s_l _vfprintf_s_l _vfprintf_s_l _vfwprintf_s_l

Behoeften

Routine Vereiste header Optionele headers
vfprintf_s, _vfprintf_s_l <stdio.h> en <stdarg.h> <varargs.h>*
vfwprintf_s, _vfwprintf_s_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