CKTIS / C
vprintf — geformatteerde uitvoer vanuit een va_list
vprintf schrijft geformatteerde tekst naar stdout met argumenten uit een va_list. Hiermee kun je aangepaste uitvoerfuncties maken die een variabel aantal argumenten accepteren.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
#include <stdio.h>
int vprintf(const char * restrict format, va_list arg);vprintf werkt zoals printf, maar accepteert een va_list in plaats van argumenten via .... De functie schrijft naar stdout; met vfprintf kun je een stream kiezen.
Initialiseer de lijst met va_start. Gebruik de lijst na de aanroep niet opnieuw zonder deze opnieuw te initialiseren; roep va_end aan. Gebruik voor een onafhankelijke doorgang eerst va_copy en daarna een afzonderlijke va_end.
Als er na verwerking van het volledige formaat nog argumenten overblijven, worden die genegeerd. Het gedrag is ongedefinieerd als er te weinig argumenten zijn of als het type van een argument na de standaardargumentpromoties niet overeenkomt met het type dat de bijbehorende conversiespecificatie vereist. Geef niet-vertrouwde tekst door als gegevens voor %s, niet als formaat.
De retourwaarde is het aantal verzonden tekens, of een negatieve waarde bij een uitvoer- of coderingsfout. Het voorbeeld verwacht 10, inclusief \n.
Voorbeelden
#include <stdarg.h>
#include <stdio.h>
#include <stdlib.h>
static int print_message(const char *format, ...)
{
va_list args;
va_start(args, format);
int result = vprintf(format, args);
va_end(args);
return result;
}
int main(void)
{
int count = print_message("%s: %d\n", "Score", 42);
if (count != 10) {
return EXIT_FAILURE;
}
if (fflush(stdout) == EOF) {
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}Resultaat
Score: 42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.