Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

vsprintf — formátovanie do buffera pomocou va_list

vsprintf zapisuje formátovaný text do buffera a argumenty získava z va_list. Veľkosť buffera neprijíma.

Verzia: C23; repository compiler flag, production runtime not attested

Syntax

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

vsprintf funguje ako sprintf, ale namiesto argumentov ... prijíma va_list. Do s zapisuje aj ukončovací nulový znak.

Buffer musí pojať celý výsledok vrátane nulového znaku. Pretečenie a kopírovanie medzi prekrývajúcimi sa objektmi spôsobujú nedefinované správanie. Typy argumentov musia zodpovedať špecifikátorom formátu. Nedôveryhodný text nepoužívaj ako format; na obmedzenie zápisu zvoľ vsnprintf.

Zoznam inicializuj pomocou va_start. Funkcia va_end nevolá: zavolaj ho sám. Po volaní zoznam znovu nečítaj. Ak ho chceš samostatne prejsť, vopred si priprav kópiu pomocou va_copy.

Návratová hodnota udáva počet zapísaných znakov bez ukončovacieho nulového znaku, alebo je pri chybe kódovania záporná.

Príklady

#include <stdarg.h>
#include <stdio.h>

/* Only for calls whose complete output fits in dst. */
static int format_text(char *dst, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vsprintf(dst, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    char text[16];
    int count = format_text(text, "score=%d", 7);
    if (count < 0) {
        return 1;
    }
    puts(text);
    printf("%d\n", count);
    return 0;
}

Výsledok

score=7
7

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje