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

CKTIS / C

vsprintf — oblikovanje v medpomnilnik z uporabo va_list

vsprintf zapisuje oblikovano besedilo v medpomnilnik, argumente pa pridobi iz va_list. Velikosti medpomnilnika ne prejme.

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

Sintaksa

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

vsprintf deluje kot sprintf, vendar namesto argumentov ... sprejme va_list. V s zapiše tudi zaključni ničelni znak.

Medpomnilnik mora sprejeti celoten rezultat skupaj z ničelnim znakom. Prekoračitev in kopiranje med prekrivajočimi se objekti povzročita nedefinirano vedenje. Vrste argumentov se morajo ujemati s specifikatorji formata. Nezaupanja vrednega besedila ne uporabljaj kot format; za omejitev zapisovanja izberi vsnprintf.

Seznam inicializiraj z va_start. Funkcija ne pokliče va_end: to naredi sam. Po klicu seznama ne beri znova. Če ga želiš neodvisno pregledati, predhodno pripravi kopijo z va_copy.

Vrnjena vrednost pove število zapisanih znakov brez zaključnega ničelnega znaka ali je ob napaki pri kodiranju negativna.

Primeri

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

Rezultat

score=7
7

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

Viri