Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

vprintf — oblikovan izpis iz va_list

vprintf z argumenti iz va_list zapisuje oblikovano besedilo v stdout. Omogoča izdelavo lastnih izpisnih funkcij, ki sprejemajo spremenljivo število argumentov.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

#include <stdarg.h>
#include <stdio.h>
int vprintf(const char * restrict format, va_list arg);

vprintf deluje kot printf, vendar namesto argumentov prek ... sprejme va_list. Zapisuje v stdout; vfprintf omogoča izbiro toka.

Seznam inicializirajte z va_start. Po klicu ga ne uporabljajte znova brez ponovne inicializacije; pokličite va_end. Za neodvisen prehod najprej uporabite va_copy, nato pa ločen va_end.

Če po obdelavi celotnega formata ostanejo argumenti, se odvečni argumenti prezrejo. Vedenje je nedefinirano, če je argumentov premalo ali če tip katerega od argumentov po privzetih tipskih promocijah ne ustreza tipu, ki ga zahteva pripadajoča specifikacija pretvorbe. Nezaupano besedilo podajte kot podatek za %s, ne kot format.

Vrnjena vrednost pove število poslanih znakov ali je negativna ob napaki izpisa oziroma kodiranja. Primer pričakuje 10, vključno z \n.

Primeri

#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;
}

Rezultat

Score: 42

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri